[[["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-12 UTC."],[],[],null,["# Class BucketNotification (3.3.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.3.0 (latest)](/python/docs/reference/storage/latest/google.cloud.storage.notification.BucketNotification)\n- [3.2.0](/python/docs/reference/storage/3.2.0/google.cloud.storage.notification.BucketNotification)\n- [3.1.1](/python/docs/reference/storage/3.1.1/google.cloud.storage.notification.BucketNotification)\n- [3.0.0](/python/docs/reference/storage/3.0.0/google.cloud.storage.notification.BucketNotification)\n- [2.19.0](/python/docs/reference/storage/2.19.0/google.cloud.storage.notification.BucketNotification)\n- [2.17.0](/python/docs/reference/storage/2.17.0/google.cloud.storage.notification.BucketNotification)\n- [2.16.0](/python/docs/reference/storage/2.16.0/google.cloud.storage.notification.BucketNotification)\n- [2.15.0](/python/docs/reference/storage/2.15.0/google.cloud.storage.notification.BucketNotification)\n- [2.14.0](/python/docs/reference/storage/2.14.0/google.cloud.storage.notification.BucketNotification)\n- [2.13.0](/python/docs/reference/storage/2.13.0/google.cloud.storage.notification.BucketNotification)\n- [2.12.0](/python/docs/reference/storage/2.12.0/google.cloud.storage.notification.BucketNotification)\n- [2.11.0](/python/docs/reference/storage/2.11.0/google.cloud.storage.notification.BucketNotification)\n- [2.10.0](/python/docs/reference/storage/2.10.0/google.cloud.storage.notification.BucketNotification)\n- [2.9.0](/python/docs/reference/storage/2.9.0/google.cloud.storage.notification.BucketNotification)\n- [2.8.0](/python/docs/reference/storage/2.8.0/google.cloud.storage.notification.BucketNotification)\n- [2.7.0](/python/docs/reference/storage/2.7.0/google.cloud.storage.notification.BucketNotification)\n- [2.6.0](/python/docs/reference/storage/2.6.0/google.cloud.storage.notification.BucketNotification)\n- [2.5.0](/python/docs/reference/storage/2.5.0/google.cloud.storage.notification.BucketNotification)\n- [2.4.0](/python/docs/reference/storage/2.4.0/google.cloud.storage.notification.BucketNotification)\n- [2.3.0](/python/docs/reference/storage/2.3.0/google.cloud.storage.notification.BucketNotification)\n- [2.2.1](/python/docs/reference/storage/2.2.1/google.cloud.storage.notification.BucketNotification)\n- [2.1.0](/python/docs/reference/storage/2.1.0/google.cloud.storage.notification.BucketNotification)\n- [2.0.0](/python/docs/reference/storage/2.0.0/google.cloud.storage.notification.BucketNotification)\n- [1.44.0](/python/docs/reference/storage/1.44.0/google.cloud.storage.notification.BucketNotification)\n- [1.43.0](/python/docs/reference/storage/1.43.0/google.cloud.storage.notification.BucketNotification)\n- [1.42.3](/python/docs/reference/storage/1.42.3/google.cloud.storage.notification.BucketNotification)\n- [1.41.1](/python/docs/reference/storage/1.41.1/google.cloud.storage.notification.BucketNotification)\n- [1.40.0](/python/docs/reference/storage/1.40.0/google.cloud.storage.notification.BucketNotification)\n- [1.39.0](/python/docs/reference/storage/1.39.0/google.cloud.storage.notification.BucketNotification)\n- [1.38.0](/python/docs/reference/storage/1.38.0/google.cloud.storage.notification.BucketNotification)\n- [1.37.1](/python/docs/reference/storage/1.37.1/google.cloud.storage.notification.BucketNotification)\n- [1.36.2](/python/docs/reference/storage/1.36.2/google.cloud.storage.notification.BucketNotification)\n- [1.35.1](/python/docs/reference/storage/1.35.1/google.cloud.storage.notification.BucketNotification)\n- [1.34.0](/python/docs/reference/storage/1.34.0/google.cloud.storage.notification.BucketNotification)\n- [1.33.0](/python/docs/reference/storage/1.33.0/google.cloud.storage.notification.BucketNotification)\n- [1.32.0](/python/docs/reference/storage/1.32.0/google.cloud.storage.notification.BucketNotification)\n- [1.31.2](/python/docs/reference/storage/1.31.2/google.cloud.storage.notification.BucketNotification)\n- [1.30.0](/python/docs/reference/storage/1.30.0/google.cloud.storage.notification.BucketNotification)\n- [1.29.0](/python/docs/reference/storage/1.29.0/google.cloud.storage.notification.BucketNotification)\n- [1.28.1](/python/docs/reference/storage/1.28.1/google.cloud.storage.notification.BucketNotification)\n- [1.27.0](/python/docs/reference/storage/1.27.0/google.cloud.storage.notification.BucketNotification)\n- [1.26.0](/python/docs/reference/storage/1.26.0/google.cloud.storage.notification.BucketNotification)\n- [1.25.0](/python/docs/reference/storage/1.25.0/google.cloud.storage.notification.BucketNotification)\n- [1.24.1](/python/docs/reference/storage/1.24.1/google.cloud.storage.notification.BucketNotification)\n- [1.23.0](/python/docs/reference/storage/1.23.0/google.cloud.storage.notification.BucketNotification)\n- [1.22.0](/python/docs/reference/storage/1.22.0/google.cloud.storage.notification.BucketNotification)\n- [1.21.0](/python/docs/reference/storage/1.21.0/google.cloud.storage.notification.BucketNotification)\n- [1.20.0](/python/docs/reference/storage/1.20.0/google.cloud.storage.notification.BucketNotification)\n- [1.19.0](/python/docs/reference/storage/1.19.0/google.cloud.storage.notification.BucketNotification)\n- [1.18.0](/python/docs/reference/storage/1.18.0/google.cloud.storage.notification.BucketNotification)\n- [1.17.0](/python/docs/reference/storage/1.17.0/google.cloud.storage.notification.BucketNotification) \n\n BucketNotification(\n bucket,\n topic_name=None,\n topic_project=None,\n custom_attributes=None,\n event_types=None,\n blob_name_prefix=None,\n payload_format=\"NONE\",\n notification_id=None,\n )\n\nRepresent a single notification resource for a bucket.\n\nSee: \u003chttps://cloud.google.com/storage/docs/json_api/v1/notifications\u003e\n\nProperties\n----------\n\n### blob_name_prefix\n\nPrefix of blob names for which notification events are published.\n\n### bucket\n\nBucket to which the notification is bound.\n\n### client\n\nThe client bound to this notfication.\n\n### custom_attributes\n\nCustom attributes passed with notification events.\n\n### etag\n\nServer-set ETag of notification resource.\n\n### event_types\n\nEvent types for which notification events are published.\n\n### notification_id\n\nServer-set ID of notification resource.\n\n### path\n\nThe URL path for this notification.\n\n### payload_format\n\nFormat of payload of notification events.\n\n### self_link\n\nServer-set ETag of notification resource.\n\n### topic_name\n\nTopic name to which notifications are published.\n\n### topic_project\n\nProject ID of topic to which notifications are published.\n\nMethods\n-------\n\n### create\n\n create(client=None, timeout=60, retry=None)\n\nAPI wrapper: create the notification.\n\nSee:\n\u003chttps://cloud.google.com/storage/docs/json_api/v1/notifications/insert\u003e\n\nIf `user_project` is set on the bucket, bills the API request\nto that project.\n\n### delete\n\n delete(client=None, timeout=60, retry=\u003cgoogle.api_core.retry.retry_unary.Retry object\u003e)\n\nDelete this notification.\n\nSee:\n\u003chttps://cloud.google.com/storage/docs/json_api/v1/notifications/delete\u003e\n\nIf `user_project` is set on the bucket, bills the API request\nto that project.\n\n### exists\n\n exists(client=None, timeout=60, retry=\u003cgoogle.api_core.retry.retry_unary.Retry object\u003e)\n\nTest whether this notification exists.\n\nSee:\n\u003chttps://cloud.google.com/storage/docs/json_api/v1/notifications/get\u003e\n\nIf `user_project` is set on the bucket, bills the API request\nto that project.\n\n### from_api_repr\n\n from_api_repr(resource, bucket)\n\nConstruct an instance from the JSON repr returned by the server.\n\nSee: \u003chttps://cloud.google.com/storage/docs/json_api/v1/notifications\u003e\n\n### reload\n\n reload(client=None, timeout=60, retry=\u003cgoogle.api_core.retry.retry_unary.Retry object\u003e)\n\nUpdate this notification from the server configuration.\n\nSee:\n\u003chttps://cloud.google.com/storage/docs/json_api/v1/notifications/get\u003e\n\nIf `user_project` is set on the bucket, bills the API request\nto that project."]]