Class SpeechClient (2.15.0) 

SpeechClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.speech_v1p1beta1.services.speech.transports.base.SpeechTransport]] = 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>)

Layanan yang menerapkan Google Cloud Speech API.

Properti

{i>transport<i}

Menampilkan transport yang digunakan oleh instance klien.

Menampilkan
JenisDeskripsi
SpeechTransportTransportasi yang digunakan oleh instance klien.

Metode

SpeechClient

SpeechClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.speech_v1p1beta1.services.speech.transports.base.SpeechTransport]] = 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 ucapan.

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, SpeechTransport]

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.

common_billing_account_path

common_billing_account_path(billing_account: str) -> str

Menampilkan string billing_account yang sepenuhnya memenuhi syarat.

common_folder_path

common_folder_path(folder: str) -> str

Menampilkan string folder yang sepenuhnya memenuhi syarat.

common_location_path

common_location_path(project: str, location: str) -> str

Menampilkan string lokasi yang sepenuhnya memenuhi syarat.

common_organization_path

common_organization_path(organization: str) -> str

Menampilkan string organisasi yang sepenuhnya memenuhi syarat.

common_project_path

common_project_path(project: str) -> str

Menampilkan string project yang sepenuhnya memenuhi syarat.

custom_class_path

custom_class_path(project: str, location: str, custom_class: str) -> str

Menampilkan string custom_class yang sepenuhnya memenuhi syarat.

from_service_account_file

from_service_account_file(filename: str, *args, **kwargs)

Membuat instance klien ini menggunakan file kredensial yang disediakan.

Parameter
NamaDeskripsi
filename str

Jalur ke file json kunci pribadi akun layanan.

Menampilkan
JenisDeskripsi
SpeechClientKlien yang dibuat.

from_service_account_info

from_service_account_info(info: dict, *args, **kwargs)

Membuat instance klien ini menggunakan info kredensial yang diberikan.

Parameter
NamaDeskripsi
info dict

Info kunci pribadi akun layanan.

Menampilkan
JenisDeskripsi
SpeechClientKlien yang dibuat.

from_service_account_json

from_service_account_json(filename: str, *args, **kwargs)

Membuat instance klien ini menggunakan file kredensial yang disediakan.

Parameter
NamaDeskripsi
filename str

Jalur ke file json kunci pribadi akun layanan.

Menampilkan
JenisDeskripsi
SpeechClientKlien yang dibuat.

get_mtls_endpoint_and_cert_source

get_mtls_endpoint_and_cert_source(
    client_options: typing.Optional[
        google.api_core.client_options.ClientOptions
    ] = None,
)

Menampilkan endpoint API dan sumber sertifikat klien untuk TLS bersama.

Sumber sertifikat klien ditentukan dalam urutan berikut: (1) Jika variabel lingkungan GOOGLE_API_USE_CLIENT_CERTIFICATE bukan "true", sumber sertifikat klien adalah None. (2) jika client_options.client_cert_source diberikan, gunakan yang diberikan; jika sumber sertifikat klien default ada, gunakan yang default; jika tidak, sumber sertifikat klien adalah None.

Endpoint API ditentukan dalam urutan berikut: (1) jika client_options.api_endpoint diberikan, gunakan yang diberikan. (2) jika variabel lingkungan GOOGLE_API_USE_CLIENT_CERTIFICATE adalah "always", gunakan endpoint mTLS default; jika variabel lingkungan adalah "never", gunakan endpoint API default; jika tidak, jika sumber sertifikat klien ada, gunakan endpoint mTLS default, jika tidak, gunakan endpoint API default.

Detail selengkapnya dapat ditemukan di https://google.aip.dev/auth/4114.

Parameter
NamaDeskripsi
client_options google.api_core.client_options.ClientOptions

Opsi kustom untuk klien. Hanya properti api_endpoint dan client_cert_source yang dapat digunakan dalam metode ini.

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_operation

get_operation(
    request: typing.Optional[
        google.longrunning.operations_pb2.GetOperationRequest
    ] = 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.longrunning.operations_pb2.Operation

Mengambil status terbaru dari operasi yang berjalan lama.

Parameter
NamaDeskripsi
request .operations_pb2.GetOperationRequest

Objek permintaan. Pesan permintaan untuk metode GetOperation.

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
.operations_pb2.OperationObjek Operation.

list_operations

list_operations(
    request: typing.Optional[
        google.longrunning.operations_pb2.ListOperationsRequest
    ] = 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.longrunning.operations_pb2.ListOperationsResponse

Menampilkan operasi yang cocok dengan filter yang ditentukan dalam permintaan.

Parameter
NamaDeskripsi
request .operations_pb2.ListOperationsRequest

Objek permintaan. Pesan permintaan untuk metode ListOperations.

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
.operations_pb2.ListOperationsResponsePesan respons untuk metode ListOperations.

long_running_recognize

long_running_recognize(
    request: typing.Optional[
        typing.Union[
            google.cloud.speech_v1p1beta1.types.cloud_speech.LongRunningRecognizeRequest, dict
        ]
    ] = None,
    *,
    config: typing.Optional[
        google.cloud.speech_v1p1beta1.types.cloud_speech.RecognitionConfig
    ] = None,
    audio: typing.Optional[
        google.cloud.speech_v1p1beta1.types.cloud_speech.RecognitionAudio
    ] = 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

Melakukan pengenalan ucapan asinkron: menerima hasil melalui antarmuka google.longrunning.Operations. Menampilkan Operation.error atau Operation.response yang berisi pesan LongRunningRecognizeResponse. Untuk mengetahui informasi selengkapnya tentang pengenalan ucapan asinkron, lihat <https://cloud.google.com/speech-to-text/docs/async-recognize>.

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

def sample_long_running_recognize():
    # Create a client
    client = speech_v1p1beta1.SpeechClient()

    # Initialize request argument(s)
    config = speech_v1p1beta1.RecognitionConfig()
    config.language_code = "language_code_value"

    audio = speech_v1p1beta1.RecognitionAudio()
    audio.content = b'content_blob'

    request = speech_v1p1beta1.LongRunningRecognizeRequest(
        config=config,
        audio=audio,
    )

    # Make the request
    operation = client.long_running_recognize(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)
Parameter
NamaDeskripsi
request Union[google.cloud.speech_v1p1beta1.types.LongRunningRecognizeRequest, dict]

Objek permintaan. Pesan tingkat teratas yang dikirim oleh klien untuk metode LongRunningRecognize.

config google.cloud.speech_v1p1beta1.types.RecognitionConfig

Wajib. Memberikan informasi ke pengenal yang menentukan cara memproses permintaan. Ini sesuai dengan kolom config pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

audio google.cloud.speech_v1p1beta1.types.RecognitionAudio

Wajib. Data audio yang akan dikenali. Ini sesuai dengan kolom audio 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 LongRunningRecognizeResponse. Satu-satunya pesan yang ditampilkan ke klien oleh metode LongRunningRecognize. Objek ini berisi hasil sebagai nol atau beberapa pesan SpeechRecognitionResult berurutan. Hal ini disertakan dalam kolom result.response dari Operasi yang ditampilkan oleh panggilan GetOperation dari layanan google::longrunning::Operations.

parse_common_billing_account_path

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

Mengurai jalur billing_account ke dalam segmen komponennya.

parse_common_folder_path

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

Mengurai jalur folder ke dalam segmen komponennya.

parse_common_location_path

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

Mengurai jalur lokasi ke dalam segmen komponennya.

parse_common_organization_path

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

Mengurai jalur organisasi ke dalam segmen komponennya.

parse_common_project_path

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

Mengurai jalur project ke dalam segmen komponennya.

parse_custom_class_path

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

Mengurai jalur custom_class ke dalam segmen komponennya.

parse_phrase_set_path

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

Mengurai jalur phrase_set ke dalam segmen komponennya.

phrase_set_path

phrase_set_path(project: str, location: str, phrase_set: str) -> str

Menampilkan string phrase_set yang sepenuhnya memenuhi syarat.

kenali

recognize(
    request: typing.Optional[
        typing.Union[google.cloud.speech_v1p1beta1.types.cloud_speech.RecognizeRequest, dict]
    ] = None,
    *,
    config: typing.Optional[
        google.cloud.speech_v1p1beta1.types.cloud_speech.RecognitionConfig
    ] = None,
    audio: typing.Optional[
        google.cloud.speech_v1p1beta1.types.cloud_speech.RecognitionAudio
    ] = 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.speech_v1p1beta1.types.cloud_speech.RecognizeResponse

Melakukan pengenalan ucapan sinkron: menerima hasil setelah semua audio dikirim dan diproses.

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

def sample_recognize():
    # Create a client
    client = speech_v1p1beta1.SpeechClient()

    # Initialize request argument(s)
    config = speech_v1p1beta1.RecognitionConfig()
    config.language_code = "language_code_value"

    audio = speech_v1p1beta1.RecognitionAudio()
    audio.content = b'content_blob'

    request = speech_v1p1beta1.RecognizeRequest(
        config=config,
        audio=audio,
    )

    # Make the request
    response = client.recognize(request=request)

    # Handle the response
    print(response)
Parameter
NamaDeskripsi
request Union[google.cloud.speech_v1p1beta1.types.RecognizeRequest, dict]

Objek permintaan. Pesan tingkat teratas yang dikirim oleh klien untuk metode Recognize.

config google.cloud.speech_v1p1beta1.types.RecognitionConfig

Wajib. Memberikan informasi ke pengenal yang menentukan cara memproses permintaan. Ini sesuai dengan kolom config pada instance request; jika request diberikan, ini tidak boleh ditetapkan.

audio google.cloud.speech_v1p1beta1.types.RecognitionAudio

Wajib. Data audio yang akan dikenali. Ini sesuai dengan kolom audio 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.speech_v1p1beta1.types.RecognizeResponseSatu-satunya pesan yang ditampilkan ke klien oleh metode Recognize. Objek ini berisi hasil sebagai nol atau beberapa pesan SpeechRecognitionResult berurutan.

streaming_recognize

streaming_recognize(
    requests: typing.Optional[
        typing.Iterator[
            google.cloud.speech_v1p1beta1.types.cloud_speech.StreamingRecognizeRequest
        ]
    ] = 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]] = ()
) -> typing.Iterable[
    google.cloud.speech_v1p1beta1.types.cloud_speech.StreamingRecognizeResponse
]

Melakukan pengenalan ucapan streaming dua arah: menerima hasil saat mengirim audio. Metode ini hanya tersedia melalui gRPC API (bukan REST).

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

def sample_streaming_recognize():
    # Create a client
    client = speech_v1p1beta1.SpeechClient()

    # Initialize request argument(s)
    streaming_config = speech_v1p1beta1.StreamingRecognitionConfig()
    streaming_config.config.language_code = "language_code_value"

    request = speech_v1p1beta1.StreamingRecognizeRequest(
        streaming_config=streaming_config,
    )

    # This method expects an iterator which contains
    # 'speech_v1p1beta1.StreamingRecognizeRequest' objects
    # Here we create a generator that yields a single `request` for
    # demonstrative purposes.
    requests = [request]

    def request_generator():
        for request in requests:
            yield request

    # Make the request
    stream = client.streaming_recognize(requests=request_generator())

    # Handle the response
    for response in stream:
        print(response)
Parameter
NamaDeskripsi
requests Iterator[google.cloud.speech_v1p1beta1.types.StreamingRecognizeRequest]

Iterator objek permintaan. Pesan tingkat teratas yang dikirim oleh klien untuk metode StreamingRecognize. Beberapa pesan StreamingRecognizeRequest dikirim. Pesan pertama harus berisi pesan streaming_config dan tidak boleh berisi audio_content. Semua pesan berikutnya harus berisi audio_content dan tidak boleh berisi pesan streaming_config.

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
Iterable[google.cloud.speech_v1p1beta1.types.StreamingRecognizeResponse]StreamingRecognizeResponse adalah satu-satunya pesan yang dikembalikan ke klien oleh StreamingRecognize. Serangkaian nol atau lebih pesan StreamingRecognizeResponse di-streaming kembali ke klien. Jika tidak ada audio yang dapat dikenali, dan single_utterance disetel ke salah (false), maka tidak ada pesan yang di-streaming kembali ke klien. Berikut adalah contoh serangkaian StreamingRecognizeResponse yang mungkin ditampilkan saat memproses audio: 1. results { alternatives { transcript: "tube" } stability: 0.01 } 2. results { alternatives { transcript: "to be a" } stability: 0.01 } 3. results { alternatives { transcript: "to be" } stability: 0.9 } results { alternatives { transcript: " or not to be" } stability: 0.01 } 4. results { alternatives { transcript: "to be or not to be" confidence: 0.92 } alternatives { transcript: "to bee or not to bee" } is_final: true } 5. results { alternatives { transcript: " that's" } stability: 0.01 } 6. results { alternatives { transcript: " that is" } stability: 0.9 } results { alternatives { transcript: " the question" } stability: 0.01 } 7. results { alternatives { transcript: " that is the question" confidence: 0.98 } alternatives { transcript: " that was the question" } is_final: true } Catatan: - Hanya dua respons di atas, #4 dan #7, yang berisi hasil akhir; hal ini ditunjukkan oleh is_final: true. Menggabungkan keduanya akan menghasilkan transkrip lengkap: "to be or not to be that is the question". - Lainnya berisi hasil sementara. #3 dan #6 berisi dua \results sementara: bagian pertama memiliki stabilitas tinggi dan cenderung tidak berubah; bagian kedua memiliki stabilitas rendah dan kemungkinan besar akan berubah. Desainer UI dapat memilih untuk menampilkan hanya hasil stabilitas tinggi. - Nilai stabilitas dan keyakinan tertentu yang ditampilkan di atas hanya untuk tujuan ilustrasi. Nilai sebenarnya dapat bervariasi. - Dalam setiap respons, hanya satu kolom berikut yang akan ditetapkan: error, speech_event_type, atau satu atau beberapa hasil (berulang).