Send feedback
Class AsyncSubscriberClient (1.12.0)
Stay organized with collections
Save and categorize content based on your preferences.
Version latestkeyboard_arrow_down
AsyncSubscriberClient (
* ,
nack_handler : typing . Optional [
google . cloud . pubsublite . cloudpubsub . nack_handler . NackHandler
] = None ,
reassignment_handler : typing . Optional [
google . cloud . pubsublite . cloudpubsub . reassignment_handler . ReassignmentHandler
] = None ,
message_transformer : typing . Optional [
google . cloud . pubsublite . cloudpubsub . message_transformer . MessageTransformer
] = None ,
credentials : typing . Optional [ google . auth . credentials . Credentials ] = None ,
transport : str = "grpc_asyncio" ,
client_options : typing . Optional [ google . api_core . client_options . ClientOptions ] = None
)
An AsyncSubscriberClient reads messages similar to Google Pub/Sub, but must be used in an
async context.
Any subscribe failures are unlikely to succeed if retried.
Must be used in an async with
block or have aenter () awaited before use.
Methods
AsyncSubscriberClient
AsyncSubscriberClient (
* ,
nack_handler : typing . Optional [
google . cloud . pubsublite . cloudpubsub . nack_handler . NackHandler
] = None ,
reassignment_handler : typing . Optional [
google . cloud . pubsublite . cloudpubsub . reassignment_handler . ReassignmentHandler
] = None ,
message_transformer : typing . Optional [
google . cloud . pubsublite . cloudpubsub . message_transformer . MessageTransformer
] = None ,
credentials : typing . Optional [ google . auth . credentials . Credentials ] = None ,
transport : str = "grpc_asyncio" ,
client_options : typing . Optional [ google . api_core . client_options . ClientOptions ] = None
)
Create a new AsyncSubscriberClient.
__aenter__
Return self
upon entering the runtime context.
__aexit__
__aexit__ ( exc_type , exc_value , traceback )
Raise any exception triggered within the runtime context.
subscribe
subscribe (
subscription : typing . Union [
google . cloud . pubsublite . types . paths . SubscriptionPath , str
],
per_partition_flow_control_settings : google . cloud . pubsublite . types . flow_control_settings . FlowControlSettings ,
fixed_partitions : typing . Optional [
typing . Set [ google . cloud . pubsublite . types . partition . Partition ]
] = None ,
) - > typing . AsyncIterator [ google . cloud . pubsub_v1 . subscriber . message . Message ]
Read messages from a subscription.
Exceptions
Type
Description
GoogleApiCallError
On a permanent failure.
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class AsyncSubscriberClient (1.12.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.12.0 (latest)](/python/docs/reference/pubsublite/latest/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.11.1](/python/docs/reference/pubsublite/1.11.1/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.10.0](/python/docs/reference/pubsublite/1.10.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.9.0](/python/docs/reference/pubsublite/1.9.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.8.3](/python/docs/reference/pubsublite/1.8.3/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.7.0](/python/docs/reference/pubsublite/1.7.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.6.0](/python/docs/reference/pubsublite/1.6.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.5.0](/python/docs/reference/pubsublite/1.5.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.4.3](/python/docs/reference/pubsublite/1.4.3/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.3.0](/python/docs/reference/pubsublite/1.3.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.2.0](/python/docs/reference/pubsublite/1.2.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.1.4](/python/docs/reference/pubsublite/1.1.4/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [1.0.2](/python/docs/reference/pubsublite/1.0.2/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [0.6.1](/python/docs/reference/pubsublite/0.6.1/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [0.5.0](/python/docs/reference/pubsublite/0.5.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [0.4.1](/python/docs/reference/pubsublite/0.4.1/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [0.3.0](/python/docs/reference/pubsublite/0.3.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [0.2.0](/python/docs/reference/pubsublite/0.2.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient)\n- [0.1.0](/python/docs/reference/pubsublite/0.1.0/google.cloud.pubsublite.cloudpubsub.subscriber_client.AsyncSubscriberClient) \n\n AsyncSubscriberClient(\n *,\n nack_handler: typing.Optional[\n google.cloud.pubsublite.cloudpubsub.nack_handler.NackHandler\n ] = None,\n reassignment_handler: typing.Optional[\n google.cloud.pubsublite.cloudpubsub.reassignment_handler.ReassignmentHandler\n ] = None,\n message_transformer: typing.Optional[\n google.cloud.pubsublite.cloudpubsub.message_transformer.MessageTransformer\n ] = None,\n credentials: typing.Optional[google.auth.credentials.Credentials] = None,\n transport: str = \"grpc_asyncio\",\n client_options: typing.Optional[google.api_core.client_options.ClientOptions] = None\n )\n\nAn AsyncSubscriberClient reads messages similar to Google Pub/Sub, but must be used in an\nasync context.\nAny subscribe failures are unlikely to succeed if retried.\n\nMust be used in an `async with` block or have **aenter**() awaited before use.\n\nMethods\n-------\n\n### AsyncSubscriberClient\n\n AsyncSubscriberClient(\n *,\n nack_handler: typing.Optional[\n google.cloud.pubsublite.cloudpubsub.nack_handler.NackHandler\n ] = None,\n reassignment_handler: typing.Optional[\n google.cloud.pubsublite.cloudpubsub.reassignment_handler.ReassignmentHandler\n ] = None,\n message_transformer: typing.Optional[\n google.cloud.pubsublite.cloudpubsub.message_transformer.MessageTransformer\n ] = None,\n credentials: typing.Optional[google.auth.credentials.Credentials] = None,\n transport: str = \"grpc_asyncio\",\n client_options: typing.Optional[google.api_core.client_options.ClientOptions] = None\n )\n\nCreate a new AsyncSubscriberClient.\n\n### __aenter__\n\n __aenter__()\n\nReturn `self` upon entering the runtime context.\n\n### __aexit__\n\n __aexit__(exc_type, exc_value, traceback)\n\nRaise any exception triggered within the runtime context.\n\n### subscribe\n\n subscribe(\n subscription: typing.Union[\n google.cloud.pubsublite.types.paths.SubscriptionPath, str\n ],\n per_partition_flow_control_settings: google.cloud.pubsublite.types.flow_control_settings.FlowControlSettings,\n fixed_partitions: typing.Optional[\n typing.Set[google.cloud.pubsublite.types.partition.Partition]\n ] = None,\n ) -\u003e typing.AsyncIterator[google.cloud.pubsub_v1.subscriber.message.Message]\n\nRead messages from a subscription."]]