Method: accounts.notificationsubscriptions.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحصل على جميع اشتراكات الإشعارات للتاجر.
طلب HTTP
GET https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. حساب التاجر الذي يملك اشتراكات الإشعارات. التنسيق: accounts/{account}
|
مَعلمات طلب البحث
| المعلمات |
pageSize |
integer
الحد الأقصى لعدد الاشتراكات في الإشعارات التي يتم عرضها في الصفحة القيمة التلقائية لسمة pageSize هي 100. الحد الأقصى للقيمة هو 200. سيتم فرض القيم التي تزيد عن 200 على 200.
|
pageToken |
string
الرمز المميّز (إذا تم توفيره) لاسترداد الصفحة اللاحقة يجب أن تتطابق جميع المَعلمات الأخرى مع الطلب الأصلي الذي قدّم رمز تعريف الصفحة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الاستجابة لطريقة ListNotificationSubscription
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
notificationSubscriptions[] |
object (NotificationSubscription)
قائمة الاشتراكات في الإشعارات التي طلبها التاجر
|
nextPageToken |
string
رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-23 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-01-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves all notification subscriptions for a specified merchant account using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eAllows pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters to control the number of results and navigate through pages.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of \u003ccode\u003eNotificationSubscription\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e if further pages are available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authentication with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.notificationsubscriptions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListNotificationSubscriptionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets all the notification subscriptions for a merchant.\n\n### HTTP request\n\n`GET 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 who owns the notification subscriptions. Format: `accounts/{account}` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of notification subscriptions to return in a page. The default value for `pageSize` is 100. The maximum value is `200`. Values above `200` will be coerced to `200`. |\n| `pageToken` | `string` Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the ListNotificationSubscription method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"notificationSubscriptions\": [ { object (/merchant/api/reference/rest/notifications_v1beta/accounts.notificationsubscriptions#NotificationSubscription) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `notificationSubscriptions[]` | `object (`[NotificationSubscription](/merchant/api/reference/rest/notifications_v1beta/accounts.notificationsubscriptions#NotificationSubscription)`)` The list of notification subscriptions requested by the merchant. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\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)."]]
