2026-11-05
▼ ▲ merchantapi.accounts.notificationsubscriptions.get
Parameter Order : name
Description : Gets notification subscriptions for an account.
Flat Path : notifications/v1beta/accounts/{accountsId}/notificationsubscriptions/{notificationsubscriptionsId}
Scopes : https://www.googleapis.com/auth/content
Parameters :
name
Description : Required. The `name` of the notification subscription.
Type : string
Pattern : ^accounts/[^/]+/notificationsubscriptions/[^/]+$
Required : Yes
Location : path
HTTP Method : GET
Path : notifications/v1beta/{+name}
▼ ▲ merchantapi.accounts.notificationsubscriptions.patch
Parameters :
name
Pattern : ^accounts/[^/]+/notificationsubscriptions/[^/]+$
Required : Yes
Type : string
Location : path
Description : Output only. The `name` of the notification configuration. Generated by the Merchant API upon creation of a new `NotificationSubscription`. The `account` represents the merchant ID of the merchant that owns the configuration. Format: `accounts/{account}/notificationsubscriptions/{notification_subscription}`
updateMask
Type : string
Format : google-fieldmask
Location : query
Description : List of fields being updated.
Scopes : https://www.googleapis.com/auth/content
Description : Updates an existing notification subscription for a merchant.
Path : notifications/v1beta/{+name}
HTTP Method : PATCH
Parameter Order : name
Flat Path : notifications/v1beta/accounts/{accountsId}/notificationsubscriptions/{notificationsubscriptionsId}
▼ ▲ merchantapi.accounts.notificationsubscriptions.delete
Flat Path : notifications/v1beta/accounts/{accountsId}/notificationsubscriptions/{notificationsubscriptionsId}
Parameters :
name
Description : Required. The name of the notification subscription to be deleted.
Type : string
Location : path
Pattern : ^accounts/[^/]+/notificationsubscriptions/[^/]+$
Required : Yes
Description : Deletes a notification subscription for a merchant.
Scopes : https://www.googleapis.com/auth/content
Parameter Order : name
HTTP Method : DELETE
Path : notifications/v1beta/{+name}
▼ ▲ merchantapi.accounts.notificationsubscriptions.list
Flat Path : notifications/v1beta/accounts/{accountsId}/notificationsubscriptions
Scopes : https://www.googleapis.com/auth/content
HTTP Method : GET
Description : Gets all the notification subscriptions for a merchant.
Parameter Order : parent
Parameters :
pageSize
Description : Optional. The maximum number of notification subscriptions to return in a page. The default value for `page_size` is 100. The maximum value is `200`. Values above `200` will be coerced to `200`.
Location : query
Format : int32
Type : integer
pageToken
Location : query
Description : Optional. Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.
Type : string
parent
Location : path
Required : Yes
Description : Required. The merchant account who owns the notification subscriptions. Format: `accounts/{account}`
Pattern : ^accounts/[^/]+$
Type : string
Path : notifications/v1beta/{+parent}/notificationsubscriptions
▼ ▲ merchantapi.accounts.notificationsubscriptions.create
HTTP Method : POST
Parameter Order : parent
Path : notifications/v1beta/{+parent}/notificationsubscriptions
Flat Path : notifications/v1beta/accounts/{accountsId}/notificationsubscriptions
Parameters :
parent
Required : Yes
Location : path
Description : Required. The merchant account that owns the new notification subscription. Format: `accounts/{account}`
Type : string
Pattern : ^accounts/[^/]+$
Description : Creates a notification subscription for a business. For standalone or sub-accounts, the business can create a subscription for self. For advanced accounts, the business can create a subscription for all managed accounts or for a specific subaccount. See [Decode notifications](/merchant/api/guides/accounts/notifications#decode_notifications) for information on how to decode the notification payload and how to interpret its contents. We will allow the following types of notification subscriptions to exist together (per business as a subscriber per event type): 1. Subscription for all managed accounts + subscription for self. 2. Multiple "partial" subscriptions for managed accounts + subscription for self. we will not allow (per business as a subscriber per event type): 1. Multiple self subscriptions. 2. Multiple "all managed accounts" subscriptions. 3. "All managed accounts" subscription and partial subscriptions at the same time. 4. Multiple partial subscriptions for the same target account.