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

Fournit des opérations de traduction en langage naturel.

Propriétés

transport

Renvoie le transport utilisé par l'instance cliente.

Renvoie
TypeDescription
TranslationServiceTransportTransport utilisé par l'instance cliente.

Méthodes

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

Instancie le client du service de traduction.

Paramètres
NomDescription
credentials Optional[google.auth.credentials.Credentials]

Identifiants d'autorisation à joindre aux requêtes. Ces identifiants permettent d'identifier l'application auprès du service. Si aucun n'est spécifié, le client tentera de déterminer les identifiants à partir de l'environnement.

transport Union[str, TranslationServiceTransport]

Transport à utiliser. Si la valeur est définie sur "None", un transport est choisi automatiquement.

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

Options personnalisées pour le client. Il ne prendra pas effet si une instance transport est fournie. (1) La propriété api_endpoint peut être utilisée pour remplacer le point de terminaison par défaut fourni par le client. Variable d'environnement GOOGLE_API_USE_MTLS_ENDPOINT peut également être utilisée pour remplacer le point de terminaison : "always" (toujours utiliser le point de terminaison mTLS par défaut), "never" (toujours utiliser le point de terminaison standard par défaut) et "auto" (basculer automatiquement vers le point de terminaison mTLS par défaut si le certificat client est présent, il s'agit de la valeur par défaut). Toutefois, la propriété api_endpoint est prioritaire si elle est fournie. (2) Si la variable d'environnement GOOGLE_API_USE_CLIENT_CERTIFICATE est définie sur "true", la propriété client_cert_source peut être utilisée pour fournir un certificat client pour le transport TLS mutuel. Si aucune valeur n'est fournie, le certificat client SSL par défaut est utilisé, le cas échéant. Si GOOGLE_API_USE_CLIENT_CERTIFICATE est défini sur "false" ou n'est pas défini, aucun certificat client ne sera utilisé.

client_info google.api_core.gapic_v1.client_info.ClientInfo

Informations sur le client utilisées pour envoyer une chaîne user-agent avec les requêtes API. Si la valeur est None, les informations par défaut seront utilisées. En règle générale, vous n'avez besoin de définir cette option que si vous développez votre propre bibliothèque cliente.

Exceptions
TypeDescription
google.auth.exceptions.MutualTLSChannelErrorSi la création du transport TLS mutuel a échoué pour une raison quelconque.

__exit__

__exit__(type, value, traceback)

Libère les ressources de transport sous-jacentes.

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

Traduit un grand volume de documents en mode de traitement par lot asynchrone. Cette fonction fournit une sortie en temps réel, au fur et à mesure du traitement des entrées. Si l'appelant annule une requête, les résultats partiels (pour un fichier d'entrée, c'est tout ou rien) peuvent toujours être disponibles à l'emplacement de sortie spécifié. Cet appel renvoie immédiatement une réponse. Vous pouvez utiliser google.longrunning.Operation.name pour interroger l'état de l'appel.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.BatchTranslateDocumentRequest, dict]

Objet de la requête. Requête BatchTranslateDocument.

parent str

Obligatoire. Emplacement pour effectuer un appel régional. Format : projects/{project-number-or-id}/locations/{location-id}. L'emplacement global n'est pas compatible avec la traduction par lots. Seuls les modèles ou glossaires AutoML Translation situés dans la même région (avec le même ID de localisation) peuvent être utilisés. Dans le cas contraire, une erreur INVALID_ARGUMENT (400) est renvoyée. Cela correspond au champ parent de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

source_language_code str

Obligatoire. Code de langue ISO-639 du document d'entrée, si connu (par exemple, "en-US" ou "sr-Latn"). Les codes de langue acceptés sont listés dans Language Support https://cloud.google.com/translate/docs/languages__. Cela correspond au champ source_language_code de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

target_language_codes MutableSequence[str]

Obligatoire. Code de langue ISO-639 à utiliser pour la traduction du document d'entrée. Indiquez jusqu'à 10 codes de langue. Cela correspond au champ target_language_codes de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

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

Obligatoire. Configurations d'entrée. Le nombre total de fichiers correspondants doit être inférieur ou égal à 100. La taille totale du contenu à traduire doit être inférieure ou égale à 100 millions de points de code Unicode. Les fichiers doivent utiliser l'encodage UTF-8. Cela correspond au champ input_configs de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

output_config google.cloud.translate_v3.types.BatchDocumentOutputConfig

Obligatoire. Configuration de sortie. Si deux configurations d'entrée correspondent au même fichier (c'est-à-dire au même chemin d'entrée), nous ne générons pas de sortie pour les entrées en double. Cela correspond au champ output_config de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Renvoie
TypeDescription
google.api_core.operation.OperationObjet représentant une opération de longue durée. Le type de résultat de l'opération est BatchTranslateDocumentResponse. Il est stocké dans le champ google.longrunning.Operation.response][google.longrunning.Operation.response] renvoyé par BatchTranslateDocument si au moins un document est traduit avec succès.

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

Traduit un grand volume de texte en mode de traitement par lot asynchrone. Cette fonction fournit une sortie en temps réel, au fur et à mesure du traitement des entrées. Si l'appelant annule une requête, les résultats partiels (pour un fichier d'entrée, c'est tout ou rien) peuvent toujours être disponibles à l'emplacement de sortie spécifié. Cet appel renvoie immédiatement une réponse. Vous pouvez utiliser google.longrunning.Operation.name pour interroger l'état de l'appel.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.BatchTranslateTextRequest, dict]

Objet de la requête. Requête de traduction par lot.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Renvoie
TypeDescription
google.api_core.operation.OperationObjet représentant une opération de longue durée. Le type de résultat de l'opération est BatchTranslateResponse. Il est stocké dans le champ google.longrunning.Operation.response][google.longrunning.Operation.response] renvoyé par BatchTranslateText si au moins une phrase est traduite avec succès.

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

Crée un glossaire et renvoie l'opération de longue durée. Renvoie NOT_FOUND si le projet n'existe pas.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.CreateGlossaryRequest, dict]

Objet de la requête. Message de requête pour CreateGlossary.

parent str

Obligatoire. Nom du projet Cela correspond au champ parent de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

glossary google.cloud.translate_v3.types.Glossary

Obligatoire. Glossaire à créer. Cela correspond au champ glossary de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Renvoie
TypeDescription
google.api_core.operation.OperationObjet représentant une opération de longue durée. Le type de résultat de l'opération sera Glossary, qui représente un glossaire créé à partir des données fournies par l'utilisateur.

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

Supprime un glossaire ou annule sa création s'il n'a pas encore été créé. Renvoie NOT_FOUND si le glossaire n'existe pas.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.DeleteGlossaryRequest, dict]

Objet de la requête. Message de requête pour DeleteGlossary.

name str

Obligatoire. Nom du glossaire à supprimer. Cela correspond au champ name de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Renvoie
TypeDescription
google.api_core.operation.OperationObjet représentant une opération de longue durée. Le type de résultat de l'opération sera DeleteGlossaryResponse stocké dans le champ google.longrunning.Operation.response][google.longrunning.Operation.response] renvoyé par 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

Détecte la langue du texte dans une requête.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.DetectLanguageRequest, dict]

Objet de la requête. Message de requête pour la détection de la langue.

parent str

Obligatoire. Projet ou emplacement pour passer un appel. Doit faire référence au projet d'un appelant. Format : projects/{project-number-or-id}/locations/{location-id} ou projects/{project-number-or-id}. Pour les appels globaux, utilisez projects/{project-number-or-id}/locations/global ou projects/{project-number-or-id}. Seuls les modèles situés dans la même région (avec le même ID d'emplacement) peuvent être utilisés. Dans le cas contraire, une erreur INVALID_ARGUMENT (400) est renvoyée. Cela correspond au champ parent de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

model str

Facultatif. Modèle de détection de la langue à utiliser. Format : projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id}. Actuellement, un seul modèle de détection de la langue est accepté : projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default. Si aucun modèle n'est spécifié, le modèle par défaut est utilisé. Cela correspond au champ model de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

mime_type str

Facultatif. Format du texte source (par exemple, "text/html" ou "text/plain"). Si vous ne renseignez pas ce champ, le type MIME est défini par défaut sur "text/html". Cela correspond au champ mime_type de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

content str

Contenu de l'entrée stocké sous forme de chaîne. Cela correspond au champ content de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Paramètre
NomDescription
filename str

Chemin d'accès au fichier JSON de clé privée du compte de service.

Renvoie
TypeDescription
TranslationServiceClientClient construit.

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

Récupère un glossaire. Renvoie NOT_FOUND si le glossaire n'existe pas.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.GetGlossaryRequest, dict]

Objet de la requête. Message de requête pour GetGlossary.

name str

Obligatoire. Nom du glossaire à récupérer. Cela correspond au champ name de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Exceptions
TypeDescription
google.auth.exceptions.MutualTLSChannelErroren cas d'erreur.
Renvoie
TypeDescription
Tuple[str, Callable[[], Tuple[bytes, bytes]]]renvoie le point de terminaison de l'API et la source du certificat client à utiliser.

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

Renvoie la liste des langues disponibles pour la traduction.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.GetSupportedLanguagesRequest, dict]

Objet de la requête. Message de requête pour découvrir les langues disponibles.

parent str

Obligatoire. Projet ou emplacement pour passer un appel. Doit faire référence au projet d'un appelant. Format : projects/{project-number-or-id} ou projects/{project-number-or-id}/locations/{location-id}. Pour les appels globaux, utilisez projects/{project-number-or-id}/locations/global ou projects/{project-number-or-id}. Un emplacement non global est requis pour les modèles AutoML. Seuls les modèles d'une même région (avec le même ID de localisation) peuvent être utilisés. Sinon, une erreur INVALID_ARGUMENT (400) est renvoyée. Cela correspond au champ parent de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

model str

Facultatif. Obtenez les langues acceptées par ce modèle. Le format dépend du type de modèle : - Modèles AutoML Translation : projects/{project-number-or-id}/locations/{location-id}/models/{model-id} - Modèles généraux (intégrés) : projects/{project-number-or-id}/locations/{location-id}/models/general/nmt, renvoie les langues acceptées par le modèle spécifié. Si elle est manquante, nous obtenons les langues compatibles du modèle NMT général de Google. Cela correspond au champ model de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

display_language_code str

Facultatif. Langue à utiliser pour renvoyer les noms localisés et lisibles des langues disponibles. Si cette valeur est manquante, les noms à afficher ne sont pas renvoyés dans une réponse. Cela correspond au champ display_language_code de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Renvoie
TypeDescription
google.cloud.translate_v3.types.SupportedLanguagesMessage de réponse pour la découverte des langues disponibles.

glossary_path

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

Renvoie une chaîne de glossaire complète.

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

Répertorie les glossaires d'un projet. Renvoie NOT_FOUND si le projet n'existe pas.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.ListGlossariesRequest, dict]

Objet de la requête. Message de requête pour ListGlossaries.

parent str

Obligatoire. Nom du projet à partir duquel lister tous les glossaires. Cela correspond au champ parent de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Renvoie
TypeDescription
google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPagerMessage de réponse pour ListGlossaries. L'itération sur cet objet générera des résultats et résoudra automatiquement les pages supplémentaires.

parse_glossary_path

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

Analyse un chemin d'accès au glossaire en segments de composants.

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

Traduit les documents en mode synchrone.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.TranslateDocumentRequest, dict]

Objet de la requête. Demande de traduction de document.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.

Renvoie
TypeDescription
google.cloud.translate_v3.types.TranslateDocumentResponseMessage de réponse d'un document traduit.

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

Traduit le texte d'entrée et renvoie le texte traduit.

# 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)
Paramètres
NomDescription
request Union[google.cloud.translate_v3.types.TranslateTextRequest, dict]

Objet de la requête. Message de requête pour la traduction synchrone.

parent str

Obligatoire. Projet ou emplacement pour passer un appel. Doit faire référence au projet d'un appelant. Format : projects/{project-number-or-id} ou projects/{project-number-or-id}/locations/{location-id}. Pour les appels globaux, utilisez projects/{project-number-or-id}/locations/global ou projects/{project-number-or-id}. Un emplacement non global est requis pour les requêtes utilisant des modèles AutoML ou des glossaires personnalisés. Les modèles et les glossaires doivent se trouver dans la même région (avoir le même ID de localisation). Sinon, une erreur INVALID_ARGUMENT (400) est renvoyée. Cela correspond au champ parent de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

target_language_code str

Obligatoire. Code de langue ISO-639 à utiliser pour la traduction du texte saisi. Il doit correspondre à l'un des codes de langue listés dans la section "Langues disponibles". Cela correspond au champ target_language_code de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

contents MutableSequence[str]

Obligatoire. Contenu de l'entrée au format de chaîne. Nous vous recommandons de ne pas dépasser 30 000 points de code pour le contenu total. La longueur maximale de ce champ est de 1 024. Utilisez BatchTranslateText pour les textes plus longs. Cela correspond au champ contents de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

model str

Facultatif. Type model demandé pour cette traduction. Le format dépend du type de modèle : - Modèles AutoML Translation : projects/{project-number-or-id}/locations/{location-id}/models/{model-id} - Modèles généraux (intégrés) : projects/{project-number-or-id}/locations/{location-id}/models/general/nmt, Pour les requêtes globales (non régionalisées), utilisez location-id global. Par exemple, projects/{project-number-or-id}/locations/global/models/general/nmt. Si aucune valeur n'est fournie, le modèle Google par défaut (NMT) est utilisé. Cela correspond au champ model de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

mime_type str

Facultatif. Format du texte source (par exemple, "text/html" ou "text/plain"). Si vous ne renseignez pas ce champ, le type MIME est défini par défaut sur "text/html". Cela correspond au champ mime_type de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

source_language_code str

Facultatif. Code de langue ISO-639 du texte d'entrée, si connu (par exemple, "en-US" ou "sr-Latn"). Les codes de langue acceptés sont listés dans la section "Langues acceptées". Si la langue source n'est pas spécifiée, l'API tente de l'identifier automatiquement et la renvoie dans la réponse. Cela correspond au champ source_language_code de l'instance request. Si request est fourni, ce champ ne doit pas être défini.

retry google.api_core.retry.Retry

Indique les erreurs (le cas échéant) qui doivent être réessayées.

timeout float

Délai d'expiration pour cette requête.

metadata Sequence[Tuple[str, str]]

Chaînes à envoyer avec la requête en tant que métadonnées.