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

Menyediakan operasi terjemahan bahasa alami.

Properti

{i>transport<i}

Menampilkan transport yang digunakan oleh instance klien.

Menampilkan
JenisDeskripsi
TranslationServiceTransportTransportasi yang digunakan oleh instance klien.

Metode

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

Membuat instance klien layanan terjemahan.

Parameter
NamaDeskripsi
credentials Optional[google.auth.credentials.Credentials]

Kredensial otorisasi yang akan dilampirkan ke permintaan. Kredensial ini mengidentifikasi aplikasi ke layanan; jika tidak ada yang ditentukan, klien akan mencoba memastikan kredensial dari lingkungan.

transport Union[str, TranslationServiceTransport]

Transportasi yang akan digunakan. Jika disetel ke None, transportasi akan dipilih secara otomatis.

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

Opsi kustom untuk klien. Tindakan ini tidak akan berlaku jika instance transport diberikan. (1) Properti api_endpoint dapat digunakan untuk mengganti endpoint default yang disediakan oleh klien. Variabel lingkungan GOOGLE_API_USE_MTLS_ENDPOINT juga dapat digunakan untuk mengganti endpoint: "always" (selalu menggunakan endpoint mTLS default), "never" (selalu menggunakan endpoint reguler default), dan "auto" (beralih secara otomatis ke endpoint mTLS default jika ada sertifikat klien, ini adalah nilai default). Namun, properti api_endpoint akan diprioritaskan jika diberikan. (2) Jika variabel lingkungan GOOGLE_API_USE_CLIENT_CERTIFICATE adalah "true", properti client_cert_source dapat digunakan untuk memberikan sertifikat klien untuk transportasi TLS bersama. Jika tidak diberikan, sertifikat klien SSL default akan digunakan jika ada. Jika GOOGLE_API_USE_CLIENT_CERTIFICATE adalah "false" atau tidak disetel, tidak ada sertifikat klien yang akan digunakan.

client_info google.api_core.gapic_v1.client_info.ClientInfo

Info klien yang digunakan untuk mengirim string agen pengguna bersama dengan permintaan API. Jika None, info default akan digunakan. Umumnya, Anda hanya perlu menyetel ini jika Anda mengembangkan library klien Anda sendiri.

Pengecualian
JenisDeskripsi
google.auth.exceptions.MutualTLSChannelErrorJika pembuatan transport TLS bersama gagal karena alasan apa pun.

__exit__

__exit__(type, value, traceback)

Melepaskan resource transportasi yang mendasarinya.

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

Menerjemahkan dokumen dalam jumlah besar dalam mode batch asinkron. Fungsi ini memberikan output real-time saat input diproses. Jika pemanggil membatalkan permintaan, hasil parsial (untuk file input, semuanya atau tidak sama sekali) mungkin masih tersedia di lokasi output yang ditentukan. Panggilan ini akan segera ditampilkan dan Anda dapat menggunakan google.longrunning.Operation.name untuk melakukan polling status panggilan.

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

Objek permintaan. Permintaan BatchTranslateDocument.

parent str

Wajib. Lokasi untuk melakukan panggilan regional. Format projects/{project-number-or-id}/locations/{location-id}. Lokasi global tidak didukung untuk terjemahan batch. Hanya model atau glosarium AutoML Translation dalam region yang sama (memiliki location-id yang sama) yang dapat digunakan. Jika tidak, error INVALID_ARGUMENT (400) akan ditampilkan. Ini sesuai dengan kolom parent pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

source_language_code str

Wajib. Kode bahasa ISO-639 dari dokumen input jika diketahui, misalnya, "en-US" atau "sr-Latn". Kode bahasa yang didukung tercantum dalam Language Support https://cloud.google.com/translate/docs/languages__. Ini sesuai dengan kolom source_language_code pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

target_language_codes MutableSequence[str]

Wajib. Kode bahasa ISO-639 yang akan digunakan untuk terjemahan dokumen input. Tentukan hingga 10 kode bahasa di sini. Ini sesuai dengan kolom target_language_codes pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

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

Wajib. Konfigurasi input. Jumlah total file yang cocok harus <= 100. Total ukuran konten yang akan diterjemahkan harus <= 100 juta codepoint Unicode. File harus menggunakan encoding UTF-8. Ini sesuai dengan kolom input_configs pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

output_config google.cloud.translate_v3.types.BatchDocumentOutputConfig

Wajib. Konfigurasi output. Jika 2 konfigurasi input cocok dengan file yang sama (yaitu, jalur input yang sama), kami tidak akan menghasilkan output untuk input duplikat. Ini sesuai dengan kolom output_config pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
JenisDeskripsi
google.api_core.operation.OperationObjek yang merepresentasikan operasi yang berjalan lama. Jenis hasil untuk operasi ini adalah BatchTranslateDocumentResponse yang Disimpan di kolom google.longrunning.Operation.response][google.longrunning.Operation.response] yang ditampilkan oleh BatchTranslateDocument jika setidaknya satu dokumen berhasil diterjemahkan.

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

Menerjemahkan teks dalam jumlah besar dalam mode batch asinkron. Fungsi ini memberikan output real-time saat input diproses. Jika pemanggil membatalkan permintaan, hasil parsial (untuk file input, semuanya atau tidak sama sekali) mungkin masih tersedia di lokasi output yang ditentukan. Panggilan ini akan segera ditampilkan dan Anda dapat menggunakan google.longrunning.Operation.name untuk melakukan polling status panggilan.

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

Objek permintaan. Permintaan terjemahan batch.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
JenisDeskripsi
google.api_core.operation.OperationObjek yang merepresentasikan operasi yang berjalan lama. Jenis hasil untuk operasi ini adalah BatchTranslateResponse yang Disimpan di kolom google.longrunning.Operation.response][google.longrunning.Operation.response] yang ditampilkan oleh BatchTranslateText jika setidaknya satu kalimat berhasil diterjemahkan.

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

Membuat glosarium dan menampilkan operasi yang berjalan lama. Menampilkan NOT_FOUND, jika project tidak ada.

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

Objek permintaan. Pesan permintaan untuk CreateGlossary.

parent str

Wajib. Nama project. Ini sesuai dengan kolom parent pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

glossary google.cloud.translate_v3.types.Glossary

Wajib. Glosarium yang akan dibuat. Ini sesuai dengan kolom glossary pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
JenisDeskripsi
google.api_core.operation.OperationObjek yang merepresentasikan operasi yang berjalan lama. Jenis hasil untuk operasi ini adalah Glossary Merepresentasikan glosarium yang dibuat dari data yang disediakan pengguna.

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

Menghapus glosarium, atau membatalkan pembuatan glosarium jika glosarium belum dibuat. Menampilkan NOT_FOUND, jika glosarium tidak ada.

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

Objek permintaan. Pesan permintaan untuk DeleteGlossary.

name str

Wajib. Nama glosarium yang akan dihapus. Ini sesuai dengan kolom name pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
JenisDeskripsi
google.api_core.operation.OperationObjek yang merepresentasikan operasi yang berjalan lama. Jenis hasil untuk operasi ini adalah DeleteGlossaryResponse yang Disimpan di kolom google.longrunning.Operation.response][google.longrunning.Operation.response] yang ditampilkan oleh 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

Mendeteksi bahasa teks dalam permintaan.

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

Objek permintaan. Pesan permintaan untuk deteksi bahasa.

parent str

Wajib. Project atau lokasi untuk melakukan panggilan. Harus merujuk ke project pemanggil. Format: projects/{project-number-or-id}/locations/{location-id} atau projects/{project-number-or-id}. Untuk panggilan global, gunakan projects/{project-number-or-id}/locations/global atau projects/{project-number-or-id}. Hanya model dalam region yang sama (memiliki location-id yang sama) yang dapat digunakan. Jika tidak, error INVALID_ARGUMENT (400) akan ditampilkan. Ini sesuai dengan kolom parent pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

model str

Opsional. Model deteksi bahasa yang akan digunakan. Format: projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id} Saat ini hanya satu model deteksi bahasa yang didukung: projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default. Jika tidak ditentukan, model default akan digunakan. Ini sesuai dengan kolom model pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

mime_type str

Opsional. Format teks sumber, misalnya, "text/html", "text/plain". Jika dibiarkan kosong, jenis MIME akan ditetapkan secara default ke "text/html". Ini sesuai dengan kolom mime_type pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

content str

Konten input yang disimpan sebagai string. Ini sesuai dengan kolom content pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Parameter
NamaDeskripsi
filename str

Jalur ke file json kunci pribadi akun layanan.

Menampilkan
JenisDeskripsi
TranslationServiceClientKlien yang dibuat.

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

Mendapatkan glosarium. Menampilkan NOT_FOUND, jika glosarium tidak ada.

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

Objek permintaan. Pesan permintaan untuk GetGlossary.

name str

Wajib. Nama glosarium yang akan diambil. Ini sesuai dengan kolom name pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Pengecualian
JenisDeskripsi
google.auth.exceptions.MutualTLSChannelErrorJika terjadi error.
Menampilkan
JenisDeskripsi
Tuple[str, Callable[[], Tuple[bytes, bytes]]]menampilkan endpoint API dan sumber sertifikat klien yang akan digunakan.

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

Menampilkan daftar bahasa yang didukung untuk terjemahan.

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

Objek permintaan. Pesan permintaan untuk menemukan bahasa yang didukung.

parent str

Wajib. Project atau lokasi untuk melakukan panggilan. Harus merujuk ke project pemanggil. Format: projects/{project-number-or-id} atau projects/{project-number-or-id}/locations/{location-id}. Untuk panggilan global, gunakan projects/{project-number-or-id}/locations/global atau projects/{project-number-or-id}. Lokasi non-global diperlukan untuk model AutoML. Hanya model dalam region yang sama (memiliki location-id yang sama) yang dapat digunakan. Jika tidak, error INVALID_ARGUMENT (400) akan ditampilkan. Ini sesuai dengan kolom parent pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

model str

Opsional. Mendapatkan bahasa yang didukung oleh model ini. Formatnya bergantung pada jenis model: - Model AutoML Translation: projects/{project-number-or-id}/locations/{location-id}/models/{model-id} - Model umum (bawaan): projects/{project-number-or-id}/locations/{location-id}/models/general/nmt, Menampilkan bahasa yang didukung oleh model yang ditentukan. Jika tidak ada, kita akan mendapatkan bahasa yang didukung oleh model NMT umum Google. Ini sesuai dengan kolom model pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

display_language_code str

Opsional. Bahasa yang akan digunakan untuk menampilkan nama bahasa yang didukung yang dilokalkan dan dapat dibaca oleh manusia. Jika tidak ada, nama tampilan tidak akan ditampilkan dalam respons. Ini sesuai dengan kolom display_language_code pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
JenisDeskripsi
google.cloud.translate_v3.types.SupportedLanguagesPesan respons untuk menemukan bahasa yang didukung.

glossary_path

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

Menampilkan string glosarium yang sepenuhnya memenuhi syarat.

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

Mencantumkan glosarium dalam project. Menampilkan NOT_FOUND, jika project tidak ada.

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

Objek permintaan. Pesan permintaan untuk ListGlossaries.

parent str

Wajib. Nama project yang digunakan untuk mencantumkan semua glosarium. Ini sesuai dengan kolom parent pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
JenisDeskripsi
google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPagerPesan respons untuk ListGlossaries. Melakukan iterasi pada objek ini akan menghasilkan hasil dan menyelesaikan halaman tambahan secara otomatis.

parse_glossary_path

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

Mengurai jalur glosarium ke dalam segmen komponennya.

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

Menerjemahkan dokumen dalam mode sinkron.

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

Objek permintaan. Permintaan terjemahan dokumen.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
JenisDeskripsi
google.cloud.translate_v3.types.TranslateDocumentResponsePesan respons dokumen yang diterjemahkan.

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

Menerjemahkan teks input dan menampilkan teks terjemahan.

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

Objek permintaan. Pesan permintaan untuk terjemahan sinkron.

parent str

Wajib. Project atau lokasi untuk melakukan panggilan. Harus merujuk ke project pemanggil. Format: projects/{project-number-or-id} atau projects/{project-number-or-id}/locations/{location-id}. Untuk panggilan global, gunakan projects/{project-number-or-id}/locations/global atau projects/{project-number-or-id}. Lokasi non-global diperlukan untuk permintaan yang menggunakan model AutoML atau glosarium kustom. Model dan glosarium harus berada dalam region yang sama (memiliki location-id yang sama). Jika tidak, error INVALID_ARGUMENT (400) akan ditampilkan. Ini sesuai dengan kolom parent pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

target_language_code str

Wajib. Kode bahasa ISO-639 yang akan digunakan untuk terjemahan teks input, ditetapkan ke salah satu kode bahasa yang tercantum dalam Dukungan Bahasa. Ini sesuai dengan kolom target_language_code pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

contents MutableSequence[str]

Wajib. Konten input dalam format string. Sebaiknya total konten kurang dari 30.000 titik kode. Panjang maksimum kolom ini adalah 1024. Gunakan BatchTranslateText untuk teks yang lebih besar. Ini sesuai dengan kolom contents pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

model str

Opsional. Jenis model yang diminta untuk terjemahan ini. Formatnya bergantung pada jenis model: - Model AutoML Translation: projects/{project-number-or-id}/locations/{location-id}/models/{model-id} - Model umum (bawaan): projects/{project-number-or-id}/locations/{location-id}/models/general/nmt, Untuk permintaan global (non-regional), gunakan location-id global. Misalnya, projects/{project-number-or-id}/locations/global/models/general/nmt. Jika tidak diberikan, model Google default (NMT) akan digunakan. Hal ini sesuai dengan kolom model pada instance request; jika request diberikan, kolom ini tidak boleh ditetapkan.

mime_type str

Opsional. Format teks sumber, misalnya, "text/html", "text/plain". Jika dibiarkan kosong, jenis MIME akan ditetapkan secara default ke "text/html". Ini sesuai dengan kolom mime_type pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

source_language_code str

Opsional. Kode bahasa ISO-639 dari teks input jika diketahui, misalnya, "en-US" atau "sr-Latn". Kode bahasa yang didukung tercantum dalam Dukungan Bahasa. Jika bahasa sumber tidak ditentukan, API akan mencoba mengidentifikasi bahasa sumber secara otomatis dan menampilkan bahasa sumber dalam respons. Ini sesuai dengan kolom source_language_code pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

retry google.api_core.retry.Retry

Penetapan error yang harus dicoba lagi, jika ada.

timeout float

Waktu tunggu untuk permintaan ini.

metadata Sequence[Tuple[str, str]]

String yang harus dikirim bersama permintaan sebagai metadata.