Method: accounts.notificationsubscriptions.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un abonnement aux notifications pour un établissement. Pour les comptes autonomes ou les sous-comptes, l'entreprise peut créer un abonnement pour elle-même. Pour les MC, l'entreprise peut créer un abonnement pour tous les comptes gérés ou pour un sous-compte spécifique.
Nous autoriserons les types d'abonnements aux notifications suivants à coexister (par entreprise en tant qu'abonné et par type d'événement):
Abonnement pour tous les comptes gérés et abonnement pour vous-même.
Plusieurs abonnements "partiels" pour les comptes gérés, plus un abonnement pour vous-même.
Nous n'autorisons pas (par entreprise en tant qu'abonné et par type d'événement):
Plusieurs abonnements personnels
Plusieurs abonnements "Tous les comptes gérés".
Abonnement "Tous les comptes gérés" et abonnements partiels en même temps
Plusieurs abonnements partiels pour le même compte cible
Requête HTTP
POST https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Obligatoire. Compte marchand propriétaire du nouvel abonnement aux notifications. Format : accounts/{account}
|
Corps de la requête
Le corps de la requête contient une instance de NotificationSubscription.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de NotificationSubscription.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/content
Pour en savoir plus, consultez OAuth 2.0 Overview.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/01/23 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
