Method: accounts.notificationsubscriptions.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک اشتراک اعلان برای یک کسب و کار ایجاد می کند. برای حساب‌های مستقل یا حساب‌های فرعی، کسب‌وکار می‌تواند برای خودش اشتراک ایجاد کند. برای MCA ها، کسب و کار می تواند برای همه حساب های مدیریت شده یا برای یک حساب فرعی خاص اشتراک ایجاد کند.
ما به انواع زیر از اشتراک‌های اعلان اجازه می‌دهیم با هم وجود داشته باشند (به‌ازای هر کسب‌وکار به عنوان مشترک در هر نوع رویداد):
اشتراک برای همه حساب های مدیریت شده + اشتراک برای خود.
چندین اشتراک "جزئی" برای حساب های مدیریت شده + اشتراک برای خود.
ما اجازه نمی دهیم (به ازای هر کسب و کار به عنوان مشترک در هر نوع رویداد):
چندین اشتراک خود
اشتراک‌های متعدد «همه حساب‌های مدیریت‌شده».
اشتراک "همه حساب های مدیریت شده" و اشتراک های جزئی به طور همزمان.
اشتراک های جزئی چندگانه برای یک حساب هدف.
درخواست HTTP
POST https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. حساب تجاری که مالک اشتراک اعلان جدید است. قالب: accounts/{account} |
درخواست بدن
بدنه درخواست شامل یک نمونه از NotificationSubscription است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از NotificationSubscription است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/content
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-23 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-23 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
