Method: accounts.notificationsubscriptions.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea una sottoscrizione alle notifiche per un'attività. Per gli account autonomi o subaccount, l'attività può creare un abbonamento per se stessa. Per gli AMC, l'attività può creare un abbonamento per tutti gli account gestiti o per un subaccount specifico.
Consentiremo la coesistenza dei seguenti tipi di iscrizioni alle notifiche (per attività come abbonato per tipo di evento):
Abbonamento per tutti gli account gestiti + abbonamento personale.
Più abbonamenti "parziali" per gli account gestiti + abbonamento personale.
Non sono consentiti (per attività come abbonato per tipo di evento):
Più abbonamenti personali.
Più iscrizioni "tutti gli account gestiti".
Abbonamento "Tutti gli account gestiti" e abbonamenti parziali contemporaneamente.
Più abbonamenti parziali per lo stesso account di destinazione.
Richiesta HTTP
POST https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. L'account commerciante proprietario del nuovo abbonamento alle notifiche. Formato: accounts/{account}
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di NotificationSubscription.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di NotificationSubscription appena creata.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/content
Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-01-23 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
