Method: accounts.notificationsubscriptions.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt ein Benachrichtigungsabo für ein Unternehmen. Für eigenständige Konten oder Unterkonten kann das Unternehmen ein Abo für sich selbst erstellen. Bei Mehrfachkundenkonten kann das Unternehmen ein Abo für alle verwalteten Konten oder für ein bestimmtes Unterkonto erstellen.
Die folgenden Arten von Benachrichtigungsabos können gleichzeitig vorhanden sein (pro Unternehmen als Abonnent und pro Ereignistyp):
Abo für alle verwalteten Konten + Abo für mich selbst
Mehrere „teilweise“ Abos für verwaltete Konten und ein Abo für mich selbst
Folgendes ist nicht zulässig (pro Unternehmen als Abonnent und pro Ereignistyp):
Mehrere selbst abgeschlossene Abos
Mehrere Abos vom Typ „Alle verwalteten Konten“
Das Abo „Alle verwalteten Konten“ und Teilabos gleichzeitig
Mehrere teilweise Abos für dasselbe Zielkonto.
HTTP-Anfrage
POST https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Das Händlerkonto, dem das neue Benachrichtigungsabo gehört. Format: accounts/{account}
|
Anfragetext
Der Anfragetext enthält eine Instanz von NotificationSubscription.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von NotificationSubscription.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/content
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-01-23 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
