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

Fornisce operazioni di traduzione del linguaggio naturale.

Proprietà

trasporto

Restituisce il trasporto utilizzato dall'istanza client.

Restituisce
TipoDescrizione
TranslationServiceTransportIl trasporto utilizzato dall'istanza client.

Metodi

TranslationServiceClient

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

Crea un'istanza del client del servizio di traduzione.

Parametri
NomeDescrizione
credentials Optional[google.auth.credentials.Credentials]

Le credenziali di autorizzazione da allegare alle richieste. Queste credenziali identificano l'applicazione per il servizio. Se non ne vengono specificate, il client tenterà di determinare le credenziali dall'ambiente.

transport Union[str, TranslationServiceTransport]

Il trasporto da utilizzare. Se impostato su Nessuno, viene scelto automaticamente un trasporto.

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

Opzioni personalizzate per il cliente. Non avrà effetto se viene fornita un'istanza transport. (1) La proprietà api_endpoint può essere utilizzata per eseguire l'override dell'endpoint predefinito fornito dal client. La variabile di ambiente GOOGLE_API_USE_MTLS_ENDPOINT può essere utilizzata anche per eseguire l'override dell'endpoint: "always" (utilizza sempre l'endpoint mTLS predefinito), "never" (utilizza sempre l'endpoint regolare predefinito) e "auto" (passa automaticamente all'endpoint mTLS predefinito se è presente il certificato client, questo è il valore predefinito). Tuttavia, la proprietà api_endpoint ha la precedenza se fornita. (2) Se la variabile di ambiente GOOGLE_API_USE_CLIENT_CERTIFICATE è "true", la proprietà client_cert_source può essere utilizzata per fornire il certificato client per il trasporto TLS reciproco. Se non viene fornito, verrà utilizzato il certificato client SSL predefinito, se presente. Se GOOGLE_API_USE_CLIENT_CERTIFICATE è "false" o non è impostato, non verrà utilizzato alcun certificato client.

client_info google.api_core.gapic_v1.client_info.ClientInfo

Le informazioni del client utilizzate per inviare una stringa user agent insieme alle richieste API. Se None, verranno utilizzate le informazioni predefinite. In genere, devi impostare questo valore solo se stai sviluppando una libreria client personalizzata.

Eccezioni
TipoDescrizione
google.auth.exceptions.MutualTLSChannelErrorSe la creazione del trasporto TLS reciproco non è riuscita per qualsiasi motivo.

__exit__

__exit__(type, value, traceback)

Rilascia le risorse del trasporto sottostante.

batch_translate_document

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

Traduce un volume elevato di documenti in modalità batch asincrona. Questa funzione fornisce output in tempo reale durante l'elaborazione degli input. Se il chiamante annulla una richiesta, i risultati parziali (per un file di input, sono tutti o nessuno) potrebbero comunque essere disponibili nella posizione di output specificata. Questa chiamata viene restituita immediatamente e puoi utilizzare google.longrunning.Operation.name per eseguire il polling dello stato della chiamata.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.BatchTranslateDocumentRequest, dict]

L'oggetto richiesta. La richiesta BatchTranslateDocument.

parent str

Obbligatorio. Posizione da cui effettuare una chiamata regionale. Formato: projects/{project-number-or-id}/locations/{location-id}. La località global non è supportata per la traduzione batch. Possono essere utilizzati solo modelli AutoML Translation o glossari all'interno della stessa regione (con lo stesso ID località), altrimenti viene restituito un errore INVALID_ARGUMENT (400). Corrisponde al campo parent nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

source_language_code str

Obbligatorio. Il codice lingua ISO-639 del documento di input, se noto, ad esempio "en-US" o "sr-Latn". I codici lingua supportati sono elencati in Language Support https://cloud.google.com/translate/docs/languages__. Corrisponde al campo source_language_code nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

target_language_codes MutableSequence[str]

Obbligatorio. Il codice lingua ISO-639 da utilizzare per la traduzione del documento di input. Specifica fino a 10 codici di lingua qui. Corrisponde al campo target_language_codes nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

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

Obbligatorio. Configurazioni di input. Il numero totale di file corrispondenti deve essere inferiore o uguale a 100. La dimensione totale dei contenuti da tradurre deve essere inferiore o uguale a 100 milioni di punti di codice Unicode. I file devono utilizzare la codifica UTF-8. Corrisponde al campo input_configs nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

output_config google.cloud.translate_v3.types.BatchDocumentOutputConfig

Obbligatorio. Configurazione dell'output. Se due configurazioni di input corrispondono allo stesso file (ovvero allo stesso percorso di input), non generiamo output per gli input duplicati. Corrisponde al campo output_config nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Restituisce
TipoDescrizione
google.api_core.operation.OperationUn oggetto che rappresenta un'operazione a lunga esecuzione. Il tipo di risultato per l'operazione sarà BatchTranslateDocumentResponse memorizzato nel campo google.longrunning.Operation.response][google.longrunning.Operation.response] restituito da BatchTranslateDocument se almeno un documento viene tradotto correttamente.

batch_translate_text

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

Traduce un grande volume di testo in modalità batch asincrona. Questa funzione fornisce output in tempo reale durante l'elaborazione degli input. Se il chiamante annulla una richiesta, i risultati parziali (per un file di input, sono tutti o nessuno) potrebbero comunque essere disponibili nella posizione di output specificata. Questa chiamata viene restituita immediatamente e puoi utilizzare google.longrunning.Operation.name per eseguire il polling dello stato della chiamata.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.BatchTranslateTextRequest, dict]

L'oggetto richiesta. La richiesta di traduzione batch.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Restituisce
TipoDescrizione
google.api_core.operation.OperationUn oggetto che rappresenta un'operazione a lunga esecuzione. Il tipo di risultato per l'operazione sarà BatchTranslateResponse memorizzato nel campo google.longrunning.Operation.response][google.longrunning.Operation.response] restituito da BatchTranslateText se almeno una frase viene tradotta correttamente.

create_glossary

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

Crea un glossario e restituisce l'operazione a lunga esecuzione. Restituisce NOT_FOUND se il progetto non esiste.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.CreateGlossaryRequest, dict]

L'oggetto richiesta. Messaggio di richiesta per CreateGlossary.

parent str

Obbligatorio. Il nome del progetto. Corrisponde al campo parent nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

glossary google.cloud.translate_v3.types.Glossary

Obbligatorio. Il glossario da creare. Corrisponde al campo glossary nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Restituisce
TipoDescrizione
google.api_core.operation.OperationUn oggetto che rappresenta un'operazione a lunga esecuzione. Il tipo di risultato per l'operazione sarà Glossario, che rappresenta un glossario creato a partire dai dati forniti dagli utenti.

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 un glossario o annulla la creazione del glossario se non è ancora stato creato. Restituisce NOT_FOUND se il glossario non esiste.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.DeleteGlossaryRequest, dict]

L'oggetto richiesta. Messaggio di richiesta per DeleteGlossary.

name str

Obbligatorio. Il nome del glossario da eliminare. Corrisponde al campo name nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Restituisce
TipoDescrizione
google.api_core.operation.OperationUn oggetto che rappresenta un'operazione a lunga esecuzione. Il tipo di risultato per l'operazione sarà DeleteGlossaryResponse memorizzato nel campo google.longrunning.Operation.response][google.longrunning.Operation.response] restituito da 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

Rileva la lingua del testo all'interno di una richiesta.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.DetectLanguageRequest, dict]

L'oggetto richiesta. Il messaggio di richiesta per il rilevamento della lingua.

parent str

Obbligatorio. Progetto o posizione da chiamare. Deve fare riferimento al progetto di un chiamante. Formato: projects/{project-number-or-id}/locations/{location-id} o projects/{project-number-or-id}. Per le chiamate globali, utilizza projects/{project-number-or-id}/locations/global o projects/{project-number-or-id}. Possono essere utilizzati solo i modelli all'interno della stessa regione (con lo stesso ID località). In caso contrario, viene restituito un errore INVALID_ARGUMENT (400). Corrisponde al campo parent nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

model str

Facoltativo. Il modello di rilevamento della lingua da utilizzare. Formato: projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id} al momento è supportato un solo modello di rilevamento della lingua: projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default. Se non specificato, viene utilizzato il modello predefinito. Corrisponde al campo model nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

mime_type str

Facoltativo. Il formato del testo di origine, ad esempio "text/html", "text/plain". Se non viene specificato, il tipo MIME predefinito è "text/html". Corrisponde al campo mime_type nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

content str

Il contenuto dell'input memorizzato come stringa. Corrisponde al campo content nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Parametro
NomeDescrizione
filename str

Il percorso del file JSON della chiave privata del account di servizio.

Restituisce
TipoDescrizione
TranslationServiceClientIl client creato.

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

Recupera un glossario. Restituisce NOT_FOUND se il glossario non esiste.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.GetGlossaryRequest, dict]

L'oggetto richiesta. Messaggio di richiesta per GetGlossary.

name str

Obbligatorio. Il nome del glossario da recuperare. Corrisponde al campo name nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Eccezioni
TipoDescrizione
google.auth.exceptions.MutualTLSChannelErrorSe si verificano errori.
Restituisce
TipoDescrizione
Tuple[str, Callable[[], Tuple[bytes, bytes]]]restituisce l'endpoint API e l'origine del certificato client da utilizzare.

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

Restituisce un elenco delle lingue supportate per la traduzione.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.GetSupportedLanguagesRequest, dict]

L'oggetto richiesta. Il messaggio di richiesta per il rilevamento delle lingue supportate.

parent str

Obbligatorio. Progetto o posizione da chiamare. Deve fare riferimento al progetto di un chiamante. Formato: projects/{project-number-or-id} o projects/{project-number-or-id}/locations/{location-id}. Per le chiamate globali, utilizza projects/{project-number-or-id}/locations/global o projects/{project-number-or-id}. Per i modelli AutoML è necessaria una località non globale. Possono essere utilizzati solo i modelli all'interno della stessa regione (con lo stesso ID località), altrimenti viene restituito un errore INVALID_ARGUMENT (400). Corrisponde al campo parent nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

model str

Facoltativo. Visualizza le lingue supportate di questo modello. Il formato dipende dal tipo di modello: - Modelli AutoML Translation: projects/{project-number-or-id}/locations/{location-id}/models/{model-id} - Modelli generali (integrati): projects/{project-number-or-id}/locations/{location-id}/models/general/nmt, restituisce le lingue supportate dal modello specificato. Se non è presente, vengono recuperate le lingue supportate del modello NMT generale di Google. Corrisponde al campo model nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

display_language_code str

Facoltativo. La lingua da utilizzare per restituire nomi leggibili e localizzati delle lingue supportate. Se manca, i nomi visualizzati non vengono restituiti in una risposta. Corrisponde al campo display_language_code nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Restituisce
TipoDescrizione
google.cloud.translate_v3.types.SupportedLanguagesIl messaggio di risposta per il rilevamento delle lingue supportate.

glossary_path

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

Restituisce una stringa del glossario completa.

list_glossaries

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

Elenca i glossari in un progetto. Restituisce NOT_FOUND se il progetto non esiste.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.ListGlossariesRequest, dict]

L'oggetto richiesta. Messaggio di richiesta per ListGlossaries.

parent str

Obbligatorio. Il nome del progetto da cui elencare tutti i glossari. Corrisponde al campo parent nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Restituisce
TipoDescrizione
google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPagerMessaggio di risposta per ListGlossaries. L'iterazione su questo oggetto produrrà risultati e risolverà automaticamente le pagine aggiuntive.

parse_glossary_path

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

Analizza un percorso del glossario nei suoi segmenti componenti.

translate_document

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

Traduce i documenti in modalità sincrona.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.TranslateDocumentRequest, dict]

L'oggetto richiesta. Una richiesta di traduzione di un documento.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.

Restituisce
TipoDescrizione
google.cloud.translate_v3.types.TranslateDocumentResponseUn messaggio di risposta al documento tradotto.

translate_text

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

Traduce il testo di input e restituisce il testo tradotto.

# 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)
Parametri
NomeDescrizione
request Union[google.cloud.translate_v3.types.TranslateTextRequest, dict]

L'oggetto richiesta. Il messaggio di richiesta per la traduzione sincrona.

parent str

Obbligatorio. Progetto o posizione da chiamare. Deve fare riferimento al progetto di un chiamante. Formato: projects/{project-number-or-id} o projects/{project-number-or-id}/locations/{location-id}. Per le chiamate globali, utilizza projects/{project-number-or-id}/locations/global o projects/{project-number-or-id}. La località non globale è obbligatoria per le richieste che utilizzano modelli AutoML o glossari personalizzati. I modelli e i glossari devono trovarsi nella stessa regione (avere lo stesso ID località), altrimenti viene restituito un errore INVALID_ARGUMENT (400). Corrisponde al campo parent nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

target_language_code str

Obbligatorio. Il codice lingua ISO-639 da utilizzare per la traduzione del testo di input, impostato su uno dei codici lingua elencati in Supporto delle lingue. Corrisponde al campo target_language_code nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

contents MutableSequence[str]

Obbligatorio. Il contenuto dell'input in formato stringa. Ti consigliamo di non superare i 30.000 punti di codice per i contenuti totali. La lunghezza massima di questo campo è 1024. Utilizza BatchTranslateText per testi più lunghi. Corrisponde al campo contents nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

model str

Facoltativo. Il tipo model richiesto per questa traduzione. Il formato dipende dal tipo di modello: - Modelli AutoML Translation: projects/{project-number-or-id}/locations/{location-id}/models/{model-id} - Modelli generali (integrati): projects/{project-number-or-id}/locations/{location-id}/models/general/nmt. Per le richieste globali (non regionalizzate), utilizza location-id global. Ad esempio, projects/{project-number-or-id}/locations/global/models/general/nmt. Se non viene fornito, verrà utilizzato il modello Google predefinito (NMT). Questo corrisponde al campo model nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

mime_type str

Facoltativo. Il formato del testo di origine, ad esempio "text/html", "text/plain". Se non viene specificato, il tipo MIME predefinito è "text/html". Corrisponde al campo mime_type nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

source_language_code str

Facoltativo. Il codice lingua ISO-639 del testo di input, se noto, ad esempio "en-US" o "sr-Latn". I codici lingua supportati sono elencati in Supporto delle lingue. Se la lingua di origine non è specificata, l'API tenta di identificarla automaticamente e la restituisce nella risposta. Corrisponde al campo source_language_code nell'istanza request; se viene fornito request, questo campo non deve essere impostato.

retry google.api_core.retry.Retry

Indicazione degli errori, se presenti, per cui deve essere eseguito un nuovo tentativo.

timeout float

Il timeout per questa richiesta.

metadata Sequence[Tuple[str, str]]

Stringhe da inviare insieme alla richiesta come metadati.