Diese Seite wurde von der Cloud Translation API übersetzt.

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

Bietet Übersetzungen in natürliche Sprachen.

Eigenschaften

transport

Gibt den von der Client-Instanz verwendeten Transport zurück.

Rückgabe
Typ	Beschreibung
`TranslationServiceTransport`	Der von der Clientinstanz verwendete Transport.

Methoden

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

Instanziiert den Übersetzungsdienst-Client.

Parameter
Name	Beschreibung
`credentials`	`Optional[google.auth.credentials.Credentials]` Die Autorisierungsanmeldedaten, die an Anfragen angehängt werden sollen. Mit diesen Anmeldedaten wird die Anwendung für den Dienst identifiziert. Wenn keine angegeben sind, versucht der Client, die Anmeldedaten aus der Umgebung zu ermitteln.
`transport`	`Union[str, TranslationServiceTransport]` Der zu verwendende Transport. Wenn „None“ festgelegt ist, wird automatisch ein Transport ausgewählt.
`client_options`	`Optional[Union[google.api_core.client_options.ClientOptions, dict]]` Benutzerdefinierte Optionen für den Client. Sie wird nicht angewendet, wenn eine `transport`-Instanz angegeben ist. 1. Mit der Property `api_endpoint` kann der vom Client bereitgestellte Standardendpunkt überschrieben werden. Mit der Umgebungsvariable GOOGLE_API_USE_MTLS_ENDPOINT kann der Endpunkt auch überschrieben werden: „always“ (immer den standardmäßigen mTLS-Endpunkt verwenden), „never“ (immer den standardmäßigen regulären Endpunkt verwenden) und „auto“ (automatisch zum standardmäßigen mTLS-Endpunkt wechseln, wenn ein Clientzertifikat vorhanden ist; dies ist der Standardwert). Die Property `api_endpoint` hat jedoch Vorrang, sofern sie angegeben wird. (2) Wenn die Umgebungsvariable GOOGLE_API_USE_CLIENT_CERTIFICATE auf „true“ gesetzt ist, kann die Eigenschaft `client_cert_source` verwendet werden, um ein Clientzertifikat für den gegenseitigen TLS-Transport bereitzustellen. Wenn nicht angegeben, wird das standardmäßige SSL-Clientzertifikat verwendet, sofern vorhanden. Wenn GOOGLE_API_USE_CLIENT_CERTIFICATE auf „false“ gesetzt oder nicht festgelegt ist, wird kein Clientzertifikat verwendet.
`client_info`	`google.api_core.gapic_v1.client_info.ClientInfo` Die Clientinformationen, die zum Senden eines User-Agent-Strings zusammen mit API-Anfragen verwendet werden. Wenn `None`, werden Standardinformationen verwendet. Normalerweise müssen Sie diese Einstellung nur festlegen, wenn Sie eine eigene Clientbibliothek entwickeln.

Ausnahmen
Typ	Beschreibung
`google.auth.exceptions.MutualTLSChannelError`	Wenn die Erstellung des gegenseitigen TLS-Transports aus irgendeinem Grund fehlgeschlagen ist.

exit

__exit__(type, value, traceback)

Gibt die Ressourcen des zugrunde liegenden Transports frei.

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

Übersetzt große Mengen an Dokumenten im asynchronen Batchmodus. Diese Funktion gibt Echtzeitausgabe aus, während die Eingaben verarbeitet werden. Wenn der Anrufer eine Anfrage abbricht, sind die Teilergebnisse (für eine Eingabedatei sind es alle oder keine) möglicherweise weiterhin am angegebenen Ausgabespeicherort verfügbar. Dieser Aufruf wird sofort zurückgegeben und Sie können google.longrunning.Operation.name verwenden, um den Status des Aufrufs abzufragen.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.BatchTranslateDocumentRequest, dict]` Das Anfrageobjekt. Die BatchTranslateDocument-Anfrage.
`parent`	`str` Erforderlich. Standort für einen regionalen Anruf. Format: `projects/{project-number-or-id}/locations/{location-id}`. Der Standort `global` wird für die Batchübersetzung nicht unterstützt. Es können nur AutoML Translation-Modelle oder Glossare in derselben Region (mit derselben location-id) verwendet werden. Andernfalls wird der Fehler INVALID_ARGUMENT (400) zurückgegeben. Dies entspricht dem Feld `parent` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`source_language_code`	`str` Erforderlich. Der ISO-639-Sprachcode des Eingabedokuments, sofern bekannt, z. B. „en-US“ oder „sr-Latn“. Unterstützte Sprachcodes sind in `Language Support https://cloud.google.com/translate/docs/languages`__ aufgeführt. Dies entspricht dem Feld `source_language_code` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`target_language_codes`	`MutableSequence[str]` Erforderlich. Der ISO-639-Sprachcode, der für die Übersetzung des Eingabedokuments verwendet werden soll. Geben Sie hier bis zu 10 Sprachcodes an. Dies entspricht dem Feld `target_language_codes` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`input_configs`	`MutableSequence[google.cloud.translate_v3.types.BatchDocumentInputConfig]` Erforderlich. Eingabekonfigurationen. Die Gesamtzahl der übereinstimmenden Dateien sollte maximal 100 betragen. Die Gesamtgröße des zu übersetzenden Inhalts darf 100 Millionen Unicode-Codepunkte nicht überschreiten. Die Dateien müssen UTF-8-codiert sein. Dies entspricht dem Feld `input_configs` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`output_config`	`google.cloud.translate_v3.types.BatchDocumentOutputConfig` Erforderlich. Ausgabekonfiguration Wenn zwei Eingabekonfigurationen mit derselben Datei übereinstimmen (d. h. derselbe Eingabepfad), wird keine Ausgabe für doppelte Eingaben generiert. Dies entspricht dem Feld `output_config` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Rückgabe
Typ	Beschreibung
`google.api_core.operation.Operation`	Ein Objekt, das einen Vorgang mit langer Ausführungszeit darstellt. Der Ergebnistyp für den Vorgang ist BatchTranslateDocumentResponse, der im Feld `google.longrunning.Operation.response][google.longrunning.Operation.response]` gespeichert ist, das von BatchTranslateDocument zurückgegeben wird, wenn mindestens ein Dokument erfolgreich übersetzt wurde.

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

Übersetzt große Mengen an Text im asynchronen Batchmodus. Diese Funktion gibt Echtzeitausgabe aus, während die Eingaben verarbeitet werden. Wenn der Anrufer eine Anfrage abbricht, sind die Teilergebnisse (für eine Eingabedatei sind es alle oder keine) möglicherweise weiterhin am angegebenen Ausgabespeicherort verfügbar. Dieser Aufruf wird sofort zurückgegeben und Sie können google.longrunning.Operation.name verwenden, um den Status des Aufrufs abzufragen.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.BatchTranslateTextRequest, dict]` Das Anfrageobjekt. Die Batchübersetzungsanfrage
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Rückgabe
Typ	Beschreibung
`google.api_core.operation.Operation`	Ein Objekt, das einen Vorgang mit langer Ausführungszeit darstellt. Der Ergebnistyp für den Vorgang ist BatchTranslateResponse, der im Feld `google.longrunning.Operation.response][google.longrunning.Operation.response]` gespeichert ist, das von BatchTranslateText zurückgegeben wird, wenn mindestens ein Satz erfolgreich übersetzt wurde.

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

Erstellt ein Glossar und gibt den Vorgang mit langer Ausführungszeit zurück. Gibt NOT_FOUND zurück, wenn das Projekt nicht vorhanden ist.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.CreateGlossaryRequest, dict]` Das Anfrageobjekt. Anfragenachricht für CreateGlossary.
`parent`	`str` Erforderlich. Der Projektname Dies entspricht dem Feld `parent` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`glossary`	`google.cloud.translate_v3.types.Glossary` Erforderlich. Das zu erstellende Glossar. Dies entspricht dem Feld `glossary` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Rückgabe
Typ	Beschreibung
`google.api_core.operation.Operation`	Ein Objekt, das einen Vorgang mit langer Ausführungszeit darstellt. Der Ergebnistyp für den Vorgang ist Glossary (Glossar). Er stellt ein Glossar dar, das aus von Nutzern bereitgestellten Daten erstellt wurde.

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

Löscht ein Glossar oder bricht die Glossarerstellung ab, wenn das Glossar noch nicht erstellt wurde. Gibt NOT_FOUND zurück, wenn das Glossar nicht vorhanden ist.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.DeleteGlossaryRequest, dict]` Das Anfrageobjekt. Anfragenachricht für DeleteGlossary
`name`	`str` Erforderlich. Der Name des zu löschenden Glossars. Dies entspricht dem Feld `name` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Rückgabe
Typ	Beschreibung
`google.api_core.operation.Operation`	Ein Objekt, das einen Vorgang mit langer Ausführungszeit darstellt. Der Ergebnistyp für den Vorgang ist DeleteGlossaryResponse, der im Feld `google.longrunning.Operation.response][google.longrunning.Operation.response]` gespeichert ist, das von DeleteGlossary zurückgegeben wird.

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

Erkennt die Sprache des Textes einer Anfrage.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.DetectLanguageRequest, dict]` Das Anfrageobjekt. Anfragenachricht für Spracherkennung.
`parent`	`str` Erforderlich. Projekt oder Standort zum Anrufen festlegen. Muss sich auf das Projekt eines Anrufers beziehen. Format: `projects/{project-number-or-id}/locations/{location-id}` oder `projects/{project-number-or-id}`. Verwenden Sie für globale Aufrufe `projects/{project-number-or-id}/locations/global` oder `projects/{project-number-or-id}`. Es können nur Modelle in derselben Region (mit derselben location-id) verwendet werden. Andernfalls wird der Fehler INVALID_ARGUMENT (400) zurückgegeben. Dies entspricht dem Feld `parent` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`model`	`str` Optional. Das zu verwendende Spracherkennungsmodell. Format: `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id}` Derzeit wird nur ein Spracherkennungsmodell unterstützt: `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default`. Wenn keine Angabe erfolgt, wird das Standardmodell verwendet. Dies entspricht dem Feld `model` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`mime_type`	`str` Optional. Das Format des Quelltexts, z. B. „text/html“ oder „text/plain“. Wenn Sie hier nichts eingeben, wird standardmäßig der MIME-Typ „text/html“ verwendet. Dies entspricht dem Feld `mime_type` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`content`	`str` Der Inhalt der Eingabe, die als String gespeichert ist. Dies entspricht dem Feld `content` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Parameter
Name	Beschreibung
`filename`	`str` Der Pfad zur JSON-Datei mit dem privaten Schlüssel des Dienstkontos.

Rückgabe
Typ	Beschreibung
`TranslationServiceClient`	Der erstellte Client.

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

Ruft ein Glossar ab. Gibt NOT_FOUND zurück, wenn das Glossar nicht vorhanden ist.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.GetGlossaryRequest, dict]` Das Anfrageobjekt. Anfragenachricht für GetGlossary
`name`	`str` Erforderlich. Der Name des abzurufenden Glossars. Dies entspricht dem Feld `name` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Ausnahmen
Typ	Beschreibung
`google.auth.exceptions.MutualTLSChannelError`	Wenn Fehler auftreten.

Rückgabe
Typ	Beschreibung
`Tuple[str, Callable[[], Tuple[bytes, bytes]]]`	Gibt den zu verwendenden API-Endpunkt und die Clientzertifikatsquelle zurück.

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

Gibt eine Liste der unterstützten Sprachen für die Übersetzung zurück.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.GetSupportedLanguagesRequest, dict]` Das Anfrageobjekt. Die Anfragenachricht zum Ermitteln unterstützter Sprachen.
`parent`	`str` Erforderlich. Projekt oder Standort zum Anrufen festlegen. Muss sich auf das Projekt eines Anrufers beziehen. Format: `projects/{project-number-or-id}` oder `projects/{project-number-or-id}/locations/{location-id}`. Verwenden Sie für globale Aufrufe `projects/{project-number-or-id}/locations/global` oder `projects/{project-number-or-id}`. Für AutoML-Modelle ist ein nicht globaler Standort erforderlich. Es können nur Modelle in derselben Region (mit derselben location-id) verwendet werden. Andernfalls wird der Fehler INVALID_ARGUMENT (400) zurückgegeben. Dies entspricht dem Feld `parent` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`model`	`str` Optional. Unterstützte Sprachen dieses Modells abrufen. Das Format hängt vom Modelltyp ab: - AutoML Translation-Modelle: `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}` - Allgemeine (integrierte) Modelle: `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`. Gibt die vom angegebenen Modell unterstützten Sprachen zurück. Falls nicht angegeben, werden die unterstützten Sprachen des allgemeinen NMÜ-Modells von Google abgerufen. Dies entspricht dem Feld `model` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`display_language_code`	`str` Optional. Die zu verwendende Sprache, um lokalisierte, für Menschen lesbare Namen der unterstützten Sprachen zurückzugeben Wenn sie fehlen, werden keine Anzeigenamen in einer Antwort zurückgegeben. Dies entspricht dem Feld `display_language_code` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Rückgabe
Typ	Beschreibung
`google.cloud.translate_v3.types.SupportedLanguages`	Die Antwortnachricht zum Ermitteln der unterstützten Sprachen:

glossary_path

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

Gibt einen voll qualifizierten Glossarstring zurück.

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

Listet Glossare in einem Projekt auf. Gibt NOT_FOUND zurück, wenn das Projekt nicht vorhanden ist.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.ListGlossariesRequest, dict]` Das Anfrageobjekt. Anfragenachricht für ListGlossaries
`parent`	`str` Erforderlich. Der Name des Projekts, aus dem alle Glossare aufgelistet werden sollen. Dies entspricht dem Feld `parent` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Rückgabe
Typ	Beschreibung
`google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPager`	Antwortnachricht für ListGlossaries. Wenn Sie dieses Objekt durchlaufen, werden Ergebnisse zurückgegeben und zusätzliche Seiten automatisch aufgelöst.

parse_glossary_path

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

Analysiert einen Glossarpfad in seine Komponenten.

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

Übersetzt Dokumente im synchronen Modus.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.TranslateDocumentRequest, dict]` Das Anfrageobjekt. Eine Anfrage zur Dokumentübersetzung.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.

Rückgabe
Typ	Beschreibung
`google.cloud.translate_v3.types.TranslateDocumentResponse`	Eine übersetzte Dokumentantwortnachricht.

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

Übersetzt Eingabetext und gibt übersetzten Text zurück.

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

Parameter
Name	Beschreibung
`request`	`Union[google.cloud.translate_v3.types.TranslateTextRequest, dict]` Das Anfrageobjekt. Die Anfragenachricht für die synchrone Übersetzung.
`parent`	`str` Erforderlich. Projekt oder Standort zum Anrufen festlegen. Muss sich auf das Projekt eines Anrufers beziehen. Format: `projects/{project-number-or-id}` oder `projects/{project-number-or-id}/locations/{location-id}`. Verwenden Sie für globale Aufrufe `projects/{project-number-or-id}/locations/global` oder `projects/{project-number-or-id}`. Für Anfragen mit AutoML-Modellen oder benutzerdefinierten Glossaren ist ein nicht globaler Standort erforderlich. Modelle und Glossare müssen sich in derselben Region befinden (dieselbe location-id haben). Andernfalls wird der Fehler INVALID_ARGUMENT (400) zurückgegeben. Dies entspricht dem Feld `parent` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`target_language_code`	`str` Erforderlich. Der ISO 639-Sprachcode, der für die Übersetzung des eingegebenen Texts verwendet werden soll. Er muss auf einen der in der Sprachunterstützung aufgeführten Sprachcodes festgelegt sein. Dies entspricht dem Feld `target_language_code` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`contents`	`MutableSequence[str]` Erforderlich. Der Inhalt der Eingabe im Stringformat. Wir empfehlen,dass der gesamte Inhalt weniger als 30.000 Codepoints umfasst. Die maximale Länge dieses Feldes beträgt 1.024 Zeichen. Verwenden Sie BatchTranslateText für längere Texte. Dies entspricht dem Feld `contents` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`model`	`str` Optional. Der für diese Übersetzung angeforderte Typ `model`. Das Format hängt vom Modelltyp ab: - AutoML Translation-Modelle: `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}` - Allgemeine (integrierte) Modelle: `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`. Verwenden Sie für globale (nicht regionalisierte) Anfragen `location-id` `global`. Beispiel: `projects/{project-number-or-id}/locations/global/models/general/nmt`. Wenn nicht angegeben, wird das Google-Standardmodell (NMÜ) verwendet. Dies entspricht dem Feld `model` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`mime_type`	`str` Optional. Das Format des Quelltexts, z. B. „text/html“ oder „text/plain“. Wenn Sie hier nichts eingeben, wird standardmäßig der MIME-Typ „text/html“ verwendet. Dies entspricht dem Feld `mime_type` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`source_language_code`	`str` Optional. Der ISO-639-Sprachcode des Eingabetexts, sofern bekannt, z. B. „en-US“ oder „sr-Latn“. Die unterstützten Sprachcodes finden Sie unter „Sprachunterstützung“. Wenn die Ausgangssprache nicht angegeben ist, versucht die API, sie automatisch zu ermitteln, und gibt sie in der Antwort zurück. Dies entspricht dem Feld `source_language_code` in der `request`-Instanz. Wenn `request` angegeben ist, sollte dies nicht festgelegt werden.
`retry`	`google.api_core.retry.Retry` Angabe, welche Fehler (falls vorhanden) wiederholt werden sollen.
`timeout`	`float` Das Zeitlimit für diese Anfrage.
`metadata`	`Sequence[Tuple[str, str]]` Strings, die zusammen mit der Anfrage als Metadaten gesendet werden sollen.