Class SpeechAsyncClient (2.15.0) 

SpeechAsyncClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Union[str, google.cloud.speech_v1p1beta1.services.speech.transports.base.SpeechTransport] = 'grpc_asyncio', client_options: typing.Optional[google.api_core.client_options.ClientOptions] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

שירות שמטמיע את Google Cloud Speech API.

מאפיינים

תחבורה

הפונקציה מחזירה את התעבורה שמשמשת את מופע הלקוח.

החזרות
סוגתיאור
SpeechTransportהתעבורה שבה נעשה שימוש במופע הלקוח.

Methods

SpeechAsyncClient

SpeechAsyncClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Union[str, google.cloud.speech_v1p1beta1.services.speech.transports.base.SpeechTransport] = 'grpc_asyncio', client_options: typing.Optional[google.api_core.client_options.ClientOptions] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

יוצרים מופע של לקוח הדיבור.

פרמטרים
שםתיאור
credentials Optional[google.auth.credentials.Credentials]

פרטי הכניסה להרשאה שצריך לצרף לבקשות. פרטי הכניסה האלה מזהים את האפליקציה בשירות. אם לא מציינים פרטי כניסה, הלקוח ינסה לקבוע את פרטי הכניסה מהסביבה.

transport Union[str, .SpeechTransport]

ההעברה שבה רוצים להשתמש. אם ההגדרה היא None, המערכת בוחרת באופן אוטומטי את שיטת ההעברה.

client_options ClientOptions

אפשרויות מותאמות אישית ללקוח. ההגדרה לא תהיה בתוקף אם יסופק מופע של transport. ‫(1) אפשר להשתמש בנכס api_endpoint כדי לבטל את נקודת הקצה שמוגדרת כברירת מחדל על ידי הלקוח. אפשר גם להשתמש במשתנה הסביבה GOOGLE_API_USE_MTLS_ENDPOINT כדי לבטל את נקודת הקצה: always (תמיד להשתמש בנקודת הקצה הרגילה), never (תמיד להשתמש בנקודת הקצה הרגילה) ו-auto (מעבר אוטומטי לנקודת הקצה הרגילה אם יש אישור לקוח, זהו ערך ברירת המחדל). עם זאת, אם מציינים את המאפיין api_endpoint, הוא מקבל עדיפות. ‫(2) אם משתנה הסביבה GOOGLE_API_USE_CLIENT_CERTIFICATE הוא true, אפשר להשתמש במאפיין client_cert_source כדי לספק אישור לקוח להעברת TLS הדדית. אם לא תציינו אישור, המערכת תשתמש באישור לקוח SSL שמוגדר כברירת מחדל, אם קיים כזה. אם המשתנה GOOGLE_API_USE_CLIENT_CERTIFICATE הוא false או לא מוגדר, לא ייעשה שימוש באישור לקוח.

חריגים
סוגתיאור
google.auth.exceptions.MutualTlsChannelErrorאם יצירת התעבורה של TLS הדדי נכשלה מסיבה כלשהי.

common_billing_account_path

common_billing_account_path(billing_account: str) -> str

מחזירה מחרוזת billing_account עם שם מלא.

common_folder_path

common_folder_path(folder: str) -> str

הפונקציה מחזירה מחרוזת של תיקייה שמוגדרת במלואה.

common_location_path

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

מחזירה מחרוזת מיקום שמוגדרת במלואה.

common_organization_path

common_organization_path(organization: str) -> str

מחזירה מחרוזת של שם הארגון שמוגדר במלואו.

common_project_path

common_project_path(project: str) -> str

מחזירה מחרוזת פרויקט שמוגדרת במלואה.

custom_class_path

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

מחזירה מחרוזת custom_class שמוגדרת במלואה.

from_service_account_file

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

יוצר מופע של הלקוח הזה באמצעות קובץ פרטי הכניסה שסופק.

פרמטר
שםתיאור
filename str

הנתיב לקובץ ה-JSON של המפתח הפרטי של חשבון השירות.

החזרות
סוגתיאור
SpeechAsyncClientהלקוח שנוצר.

from_service_account_info

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

יוצר מופע של הלקוח הזה באמצעות פרטי הכניסה שסופקו info.

פרמטר
שםתיאור
info dict

פרטי המפתח הפרטי של חשבון השירות.

החזרות
סוגתיאור
SpeechAsyncClientהלקוח שנוצר.

from_service_account_json

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

יוצר מופע של הלקוח הזה באמצעות קובץ פרטי הכניסה שסופק.

פרמטר
שםתיאור
filename str

הנתיב לקובץ ה-JSON של המפתח הפרטי של חשבון השירות.

החזרות
סוגתיאור
SpeechAsyncClientהלקוח שנוצר.

get_mtls_endpoint_and_cert_source

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

החזרת נקודת קצה ל-API ומקור אישור הלקוח ל-TLS הדדי.

מקור אישור הלקוח נקבע לפי הסדר הבא: (1) אם משתנה הסביבה GOOGLE_API_USE_CLIENT_CERTIFICATE הוא לא true, מקור אישור הלקוח הוא None. ‫(2) אם צוין client_options.client_cert_source, נעשה שימוש בערך שצוין. אם קיים מקור ברירת המחדל של אישור הלקוח, נעשה שימוש בערך ברירת המחדל. אחרת, מקור אישור הלקוח הוא None.

נקודת קצה ל-API נקבעת לפי הסדר הבא: (1) אם client_options.api_endpoint אם מסופקת, משתמשים בזו שסופקה. ‫(2) אם משתנה הסביבה GOOGLE_API_USE_CLIENT_CERTIFICATE הוא 'always', נעשה שימוש בנקודת הקצה של mTLS שמוגדרת כברירת מחדל. אם משתנה הסביבה הוא 'never', נעשה שימוש בנקודת קצה ל-API שמוגדרת כברירת מחדל. אחרת, אם קיים מקור של אישור לקוח, נעשה שימוש בנקודת הקצה של mTLS שמוגדרת כברירת מחדל. אחרת, נעשה שימוש בנקודת קצה ל-API שמוגדרת כברירת מחדל.

פרטים נוספים זמינים בכתובת https://google.aip.dev/auth/4114.

פרמטר
שםתיאור
client_options google.api_core.client_options.ClientOptions

אפשרויות מותאמות אישית ללקוח. אפשר להשתמש בשיטה הזו רק במאפיינים api_endpoint ו-client_cert_source.

חריגים
סוגתיאור
google.auth.exceptions.MutualTLSChannelErrorאם מתרחשות שגיאות.
החזרות
סוגתיאור
Tuple[str, Callable[[], Tuple[bytes, bytes]]]מחזירה את נקודת הקצה ל-API ואת המקור של אישור הלקוח שבו צריך להשתמש.

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

מקבל את המצב העדכני של פעולה ממושכת.

פרמטרים
שםתיאור
request .operations_pb2.GetOperationRequest

אובייקט הבקשה. הודעת בקשה לשיטה GetOperation.

retry google.api_core.retry.Retry

הגדרה של השגיאות שצריך לנסות שוב לתקן, אם יש כאלה.

timeout float

הזמן הקצוב לתגובה לבקשה הזו.

metadata Sequence[Tuple[str, str]]

מחרוזות שצריך לשלוח עם הבקשה כמטא-נתונים.

החזרות
סוגתיאור
.operations_pb2.Operationאובייקט Operation.

get_transport_class

get_transport_class() -> (
    typing.Type[google.cloud.speech_v1p1beta1.services.speech.transports.base.SpeechTransport]
)

מחזירה את סוג התחבורה המתאים.

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

רשימת פעולות שתואמות למסנן שצוין בבקשה.

פרמטרים
שםתיאור
request .operations_pb2.ListOperationsRequest

אובייקט הבקשה. הודעת בקשה לשיטה ListOperations.

retry google.api_core.retry.Retry

הגדרה של השגיאות שצריך לנסות שוב לתקן, אם יש כאלה.

timeout float

הזמן הקצוב לתגובה לבקשה הזו.

metadata Sequence[Tuple[str, str]]

מחרוזות שצריך לשלוח עם הבקשה כמטא-נתונים.

החזרות
סוגתיאור
.operations_pb2.ListOperationsResponseהודעת תגובה לשיטה 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_async.AsyncOperation

מבצע זיהוי דיבור אסינכרוני: מקבל תוצאות דרך הממשק google.longrunning.Operations. הפונקציה מחזירה Operation.error או Operation.response שמכיל הודעה LongRunningRecognizeResponse. מידע נוסף על זיהוי דיבור אסינכרוני זמין במאמר <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

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

    # 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 = (await operation).result()

    # Handle the response
    print(response)
פרמטרים
שםתיאור
request Optional[Union[google.cloud.speech_v1p1beta1.types.LongRunningRecognizeRequest, dict]]

אובייקט הבקשה. ההודעה ברמה העליונה שנשלחה על ידי הלקוח עבור השיטה LongRunningRecognize.

config RecognitionConfig

חובה. מספק מידע למערכת הזיהוי שמציין איך לעבד את הבקשה. הערך הזה תואם לשדה config במופע request. אם מציינים את request, לא צריך להגדיר את הערך הזה.

audio RecognitionAudio

חובה. נתוני האודיו לזיהוי. הערך הזה תואם לשדה audio במופע request. אם מציינים את request, לא צריך להגדיר את הערך הזה.

retry google.api_core.retry.Retry

הגדרה של השגיאות שצריך לנסות שוב לתקן, אם יש כאלה.

timeout float

הזמן הקצוב לתגובה לבקשה הזו.

metadata Sequence[Tuple[str, str]]

מחרוזות שצריך לשלוח עם הבקשה כמטא-נתונים.

החזרות
סוגתיאור
google.api_core.operation_async.AsyncOperationאובייקט שמייצג פעולה ממושכת. סוג התוצאה של הפעולה יהיה LongRunningRecognizeResponse. ההודעה היחידה שמוחזרת ללקוח על ידי השיטה LongRunningRecognize. הוא מכיל את התוצאה כאפס או יותר הודעות רצופות של SpeechRecognitionResult. הוא נכלל בשדה result.response של האובייקט Operation שמוחזר על ידי הקריאה GetOperation של השירות google::longrunning::Operations.

parse_common_billing_account_path

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

ניתוח נתיב של billing_account לפלחים המרכיבים אותו.

parse_common_folder_path

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

ניתוח של נתיב תיקייה לפלחי הרכיבים שלו.

parse_common_location_path

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

ניתוח של נתיב מיקום לפלחי הרכיבים שלו.

parse_common_organization_path

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

ניתוח של נתיב ארגוני לפלחים המרכיבים אותו.

parse_common_project_path

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

ניתוח של נתיב פרויקט לפלחים המרכיבים אותו.

parse_custom_class_path

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

מנתחת נתיב של custom_class לפלחים המרכיבים אותו.

parse_phrase_set_path

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

מנתח נתיב של phrase_set לפלחים המרכיבים אותו.

phrase_set_path

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

מחזירה מחרוזת phrase_set מלאה.

לזהות

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

מבצע זיהוי דיבור סינכרוני: מקבל תוצאות אחרי שכל האודיו נשלח ועבר עיבוד.

# 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

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

    # 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 = await client.recognize(request=request)

    # Handle the response
    print(response)
פרמטרים
שםתיאור
request Optional[Union[google.cloud.speech_v1p1beta1.types.RecognizeRequest, dict]]

אובייקט הבקשה. ההודעה ברמה העליונה שנשלחה על ידי הלקוח עבור השיטה Recognize.

config RecognitionConfig

חובה. מספק מידע למערכת הזיהוי שמציין איך לעבד את הבקשה. הערך הזה תואם לשדה config במופע request. אם מציינים את request, לא צריך להגדיר את הערך הזה.

audio RecognitionAudio

חובה. נתוני האודיו לזיהוי. הערך הזה תואם לשדה audio במופע request. אם מציינים את request, לא צריך להגדיר את הערך הזה.

retry google.api_core.retry.Retry

הגדרה של השגיאות שצריך לנסות שוב לתקן, אם יש כאלה.

timeout float

הזמן הקצוב לתגובה לבקשה הזו.

metadata Sequence[Tuple[str, str]]

מחרוזות שצריך לשלוח עם הבקשה כמטא-נתונים.

החזרות
סוגתיאור
google.cloud.speech_v1p1beta1.types.RecognizeResponseההודעה היחידה שמוחזרת ללקוח על ידי השיטה Recognize. הוא מכיל את התוצאה כאפס או יותר הודעות רצופות של SpeechRecognitionResult.

streaming_recognize

streaming_recognize(
    requests: typing.Optional[
        typing.AsyncIterator[
            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.Awaitable[
    typing.AsyncIterable[
        google.cloud.speech_v1p1beta1.types.cloud_speech.StreamingRecognizeResponse
    ]
]

ביצוע זיהוי דיבור בסטרימינג דו-כיווני: קבלת תוצאות בזמן שליחת אודיו. השיטה הזו זמינה רק דרך gRPC API (לא 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

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

    # 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 = await client.streaming_recognize(requests=request_generator())

    # Handle the response
    async for response in stream:
        print(response)
פרמטרים
שםתיאור
requests AsyncIterator[google.cloud.speech_v1p1beta1.types.StreamingRecognizeRequest]

האובייקט של הבקשה AsyncIterator. ההודעה ברמה העליונה שנשלחה על ידי הלקוח עבור השיטה StreamingRecognize. נשלחות כמה הודעות StreamingRecognizeRequest. ההודעה הראשונה חייבת להכיל הודעת streaming_config ואסור לה להכיל audio_content. כל ההודעות הבאות חייבות להכיל את audio_content ואסור להן להכיל הודעה עם streaming_config.

retry google.api_core.retry.Retry

הגדרה של השגיאות שצריך לנסות שוב לתקן, אם יש כאלה.

timeout float

הזמן הקצוב לתגובה לבקשה הזו.

metadata Sequence[Tuple[str, str]]

מחרוזות שצריך לשלוח עם הבקשה כמטא-נתונים.

החזרות
סוגתיאור
AsyncIterable[google.cloud.speech_v1p1beta1.types.StreamingRecognizeResponse]‫StreamingRecognizeResponse היא ההודעה היחידה שמוחזרת ללקוח על ידי StreamingRecognize. סדרה של אפס או יותר הודעות StreamingRecognizeResponse מועברת בסטרימינג חזרה ללקוח. אם אין אודיו שניתן לזיהוי, והמאפיין single_utterance מוגדר כ-false, לא מועברות הודעות בחזרה ללקוח. הנה דוגמה לסדרה של תגובות StreamingRecognizeResponse שאולי יוחזרו במהלך עיבוד אודיו: 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 } הערות: – רק שתיים מהתגובות שלמעלה, מס' 4 ומס' 7, מכילות תוצאות סופיות. הן מסומנות ב-is_final: true. השרשור של כל המילים האלה יוצר את התמליל המלא: "to be or not to be that is the question". ‫– התוצאות האחרות הן תוצאות ביניים. ‫#3 ו-‫ #6 מכילים שני ערכי ביניים \results: החלק הראשון הוא בעל יציבות גבוהה וסביר להניח שלא ישתנה, והחלק השני הוא בעל יציבות נמוכה וסביר מאוד שהוא ישתנה. מעצב ממשקי משתמש יכול לבחור להציג רק תוצאות עם יציבות גבוהה. – ערכי היציבות והוודאות הספציפיים שמוצגים למעלה הם להמחשה בלבד. הערכים בפועל עשויים להיות שונים. – בכל תגובה, רק אחד מהשדות האלה יוגדר: error,‏ speech_event_type או תוצאה אחת או יותר (חוזרות).