Method: accounts.notificationsubscriptions.create
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cria uma assinatura de notificação para uma empresa. Para contas independentes ou subcontas, a empresa pode criar uma assinatura para si mesma. Para MCAs, a empresa pode criar uma assinatura para todas as contas gerenciadas ou para uma subconta específica.
Vamos permitir que os seguintes tipos de assinaturas de notificação existam juntos (por empresa como assinante por tipo de evento):
Assinatura para todas as contas gerenciadas + assinatura para você.
Várias assinaturas "parciais" para contas gerenciadas + assinatura para si mesmo.
Não permitimos (por empresa como assinante por tipo de evento):
Várias assinaturas próprias.
Várias assinaturas de "todas as contas gerenciadas".
Assinatura "Todas as contas gerenciadas" e assinaturas parciais ao mesmo tempo.
Várias assinaturas parciais para a mesma conta de destino.
Solicitação HTTP
POST https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
parent |
string
Obrigatório. A conta do comerciante proprietária da nova assinatura de notificação. Formato: accounts/{account}
|
Corpo da solicitação
O corpo da solicitação contém uma instância de NotificationSubscription.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de NotificationSubscription.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/content
Para mais informações, consulte OAuth 2.0 Overview.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-01-23 UTC.
[null,null,["Última atualização 2025-01-23 UTC."],[[["\u003cp\u003eThis API creates notification subscriptions for businesses, allowing them to receive updates on various events.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses can create subscriptions for themselves, all managed accounts, or specific sub-accounts, with certain restrictions to avoid redundancy.\u003c/p\u003e\n"],["\u003cp\u003eThe API requires a POST request to a specific URL with the merchant account ID and a request body containing the subscription details.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will return the newly created notification subscription details.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes how to create a notification subscription for a business via a `POST` request to `https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions`. The request uses a `parent` path parameter specifying the merchant account. The request and response bodies are `NotificationSubscription` instances. Subscriptions can be for self or managed accounts, with restrictions preventing multiple full or partial subscriptions of the same type. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"],null,["# Method: accounts.notificationsubscriptions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a notification subscription for a business. For standalone or subaccounts accounts, the business can create a subscription for self. For MCAs, the business can create a subscription for all managed accounts or for a specific subaccount.\n\nWe will allow the following types of notification subscriptions to exist together (per business as a subscriber per event type):\n\n1. Subscription for all managed accounts + subscription for self.\n\n2. Multiple \"partial\" subscriptions for managed accounts + subscription for self.\n\nwe will not allow (per business as a subscriber per event type):\n\n1. Multiple self subscriptions.\n\n2. Multiple \"all managed accounts\" subscriptions.\n\n3. \"All managed accounts\" subscription and partial subscriptions at the same time.\n\n4. Multiple partial subscriptions for the same target account.\n\n### HTTP request\n\n`POST https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The merchant account that owns the new notification subscription. Format: `accounts/{account}` |\n\n### Request body\n\nThe request body contains an instance of [NotificationSubscription](/merchant/api/reference/rest/notifications_v1beta/accounts.notificationsubscriptions#NotificationSubscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [NotificationSubscription](/merchant/api/reference/rest/notifications_v1beta/accounts.notificationsubscriptions#NotificationSubscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
