فهرست مطالب
-
NotificationsApiService
(رابط) -
Attribute
(تعدادی) -
CreateNotificationSubscriptionRequest
(پیام) -
DeleteNotificationSubscriptionRequest
(پیام) -
GetNotificationSubscriptionRequest
(پیام) -
ListNotificationSubscriptionsRequest
(پیام) -
ListNotificationSubscriptionsResponse
(پیام) -
NotificationSubscription
(پیام) -
NotificationSubscription.NotificationEventType
(enum) -
ProductChange
(پیام) -
ProductStatusChangeMessage
(پیام) -
Resource
(تعدادی) -
UpdateNotificationSubscriptionRequest
(پیام)
NotificationsApiService
سرویس مدیریت اشتراک اعلانها برای بازرگانان
CreateNotificationSubscription |
---|
یک اشتراک اعلان برای یک تاجر ایجاد می کند. ما به انواع اشتراکهای اعلان زیر اجازه میدهیم با هم وجود داشته باشند (بهازای هر تاجر بهعنوان مشترک در هر نوع رویداد): 1. اشتراک برای همه حسابهای مدیریتشده + اشتراک برای خود، 2. چند اشتراک «جزئی» برای حسابهای مدیریتشده + اشتراک برای خود ما اجازه نخواهیم داد (به ازای هر تاجر به عنوان مشترک در هر نوع رویداد): 1. چندین اشتراک شخصی. 2. اشتراک های متعدد "همه حساب های مدیریت شده". 3. اشتراک تمام و جزئی به طور همزمان. 4. چند اشتراک جزئی برای یک حساب هدف
|
DeleteNotificationSubscription |
---|
اشتراک اعلان یک تاجر را حذف می کند.
|
GetNotificationSubscription |
---|
اشتراک اعلان برای یک حساب دریافت می کند.
|
ListNotificationSubscriptions |
---|
همه اشتراک های اعلان یک تاجر را دریافت می کند.
|
اشتراک UpdateNotification |
---|
اشتراک اعلان موجود برای یک تاجر را به روز می کند.
|
صفت
Enum برای مشخص کردن ویژگی در منبعی که در حال تغییر است تا به تاجر اطلاع دهد.
Enums | |
---|---|
ATTRIBUTE_UNSPECIFIED | ویژگی نامشخص |
STATUS | وضعیت موجودیت تغییر یافته |
CreateNotificationSubscriptionRequest
درخواست پیام برای روش CreateNotificationSubscription.
زمینه های | |
---|---|
parent | ضروری. حساب تجاری که مالک اشتراک اعلان جدید است. قالب: |
notification_subscription | ضروری. اشتراک اعلان برای ایجاد. |
DeleteNotificationSubscriptionRequest
درخواست پیام برای روش DeleteNotificationSubscription.
زمینه های | |
---|---|
name | ضروری. نام اشتراک اعلان که باید حذف شود. |
GetNotificationSubscriptionRequest
درخواست پیام برای روش GetNotificationSubscription.
زمینه های | |
---|---|
name | ضروری. |
ListNotificationSubscriptionsRequest
درخواست پیام برای روش ListNotificationSubscription.
زمینه های | |
---|---|
parent | ضروری. حساب تجاری که مالک اشتراکهای اعلان است. قالب: |
page_size | حداکثر تعداد اشتراک اعلان برای بازگشت در یک صفحه. مقدار پیش فرض |
page_token | رمز (در صورت ارائه) برای بازیابی صفحه بعدی. همه پارامترهای دیگر باید با فراخوانی اصلی که توکن صفحه را ارائه کرده است، مطابقت داشته باشند. |
ListNotificationSubscriptionsResponse
پیام پاسخ برای روش ListNotificationSubscription.
زمینه های | |
---|---|
notification_subscriptions[] | فهرست اشتراک های اعلان درخواستی تاجر. |
next_page_token | یک نشانه، که می تواند به عنوان |
اطلاعیه اشتراک
نشان دهنده یک اشتراک اعلان متعلق به یک حساب تجاری است.
زمینه های | |
---|---|
name | فقط خروجی |
registered_event | رویدادی که تاجر میخواهد از آن مطلع شود. |
call_back_uri | URL مورد استفاده برای ارسال اعلان به تاجر. |
زمینه اتحادیه | |
all_managed_accounts | اگر این مقدار درست باشد، حساب درخواستکننده از رویداد مشخص شده برای همه حسابهای مدیریتشده (میتواند حسابهای فرعی یا سایر حسابهای مرتبط باشد) از جمله حسابهای جدید اضافه شده به صورت روزانه مطلع میشود. |
target_account | |
NotificationEventType
نشان دهنده نوع رویدادی است که تاجر علاقه مند به دریافت اعلان برای آن است.
Enums | |
---|---|
NOTIFICATION_EVENT_TYPE_UNSPECIFIED | نوع رویداد اعلانها مشخص نشده است. |
PRODUCT_STATUS_CHANGE | اعلان وضعیت محصول تغییر می کند، برای مثال زمانی که محصول رد می شود. |
تغییر محصول
تغییری که برای محصول رخ داده است شامل ارزش قدیمی، ارزش جدید، کد کشور به عنوان کد منطقه و زمینه گزارش.
زمینه های | |
---|---|
old_value | مقدار قدیمی منبع یا ویژگی تغییر یافته است. |
new_value | مقدار جدید منبع یا ویژگی تغییر یافته. |
region_code | کشورهایی که این تغییر را دارند (در صورت وجود) |
reporting_context | گزارش زمینههایی که دارای تغییر هستند (در صورت وجود) |
پیام تغییر وضعیت محصول
پیامی که تاجر برای اطلاع از رویداد تغییر وضعیت محصول دریافت می کند
زمینه های | |
---|---|
changes[] | پیامی برای توضیح تغییری که در محصول رخ داده است |
account | حساب هدفی که مالک نهادی است که تغییر کرده است. قالب: |
managing_account | حسابی که حساب تاجر را مدیریت می کند. اگر حساب مستقل باشد، می تواند مانند شناسه تجاری باشد. قالب: |
resource_type | منبعی که تغییر کرد، در این مورد همیشه |
attribute | ویژگی موجود در منبع که تغییر کرده است، در این حالت همیشه |
resource_id | شناسه محصول |
resource | نام محصول. قالب: |
منبع
Enum برای مشخص کردن منبعی که در حال تغییر است تا به تاجر اطلاع دهد.
Enums | |
---|---|
RESOURCE_UNSPECIFIED | منبع نامشخص |
PRODUCT | نوع منبع: محصول |
UpdateNotificationSubscriptionRequest
درخواست پیام برای روش UpdateNotificationSubscription.
زمینه های | |
---|---|
notification_subscription | ضروری. نسخه جدید اشتراک اعلان که باید به روز شود. |
update_mask | لیست فیلدهای در حال به روز رسانی |