الفهرس
NotificationsApiService
(واجهة)Attribute
(تعداد)CreateNotificationSubscriptionRequest
(رسالة)DeleteNotificationSubscriptionRequest
(رسالة)GetNotificationSubscriptionRequest
(رسالة)ListNotificationSubscriptionsRequest
(رسالة)ListNotificationSubscriptionsResponse
(رسالة)NotificationSubscription
(رسالة)NotificationSubscription.NotificationEventType
(تعداد)ProductChange
(رسالة)ProductStatusChangeMessage
(رسالة)Resource
(تعداد)UpdateNotificationSubscriptionRequest
(رسالة)
NotificationsApiService
خدمة لإدارة اشتراكات الإشعارات للتجّار
CreateNotificationSubscription |
---|
لإنشاء اشتراك في إشعارات لنشاط تجاري بالنسبة إلى الحسابات المستقلة أو الحسابات الفرعية، يمكن للنشاط التجاري إنشاء اشتراك خاص به. بالنسبة إلى الحسابات المتعدّدة العملاء، يمكن للنشاط التجاري إنشاء اشتراك لجميع الحسابات المُدارة أو لحساب فرعي معيّن. سنسمح باشتراكات الإشعارات التالية معًا (لكل نشاط تجاري كمشترك لكل نوع حدث):
لن نسمح بما يلي (لكل نشاط تجاري كمشترك لكل نوع من أنواع الأحداث):
|
DeleteNotificationSubscription |
---|
لحذف اشتراك تاجر في خدمة تلقّي الإشعارات
|
GetNotificationSubscription |
---|
الحصول على اشتراكات الإشعارات لحساب معيّن
|
ListNotificationSubscriptions |
---|
تحصل على جميع اشتراكات الإشعارات للتاجر.
|
UpdateNotificationSubscription |
---|
تعديل اشتراك حالي في الإشعارات للتاجر
|
السمة
فهرس لتحديد السمة في المورد التي يتم تغييرها لإرسال إشعار بها إلى التاجر
عمليات التعداد | |
---|---|
ATTRIBUTE_UNSPECIFIED |
سمة غير محدّدة |
STATUS |
حالة الكيان الذي تم تغييره |
CreateNotificationSubscriptionRequest
رسالة طلب لطريقة CreateNotificationSubscription
الحقول | |
---|---|
parent |
مطلوب. حساب التاجر الذي يملك اشتراك الإشعارات الجديد. التنسيق: |
notification_ |
مطلوب. اشتراك الإشعار المطلوب إنشاؤه |
DeleteNotificationSubscriptionRequest
رسالة طلب لطريقة DeleteNotificationSubscription
الحقول | |
---|---|
name |
مطلوب. اسم اشتراك الإشعار المطلوب حذفه. |
GetNotificationSubscriptionRequest
رسالة طلب لطريقة GetNotificationSubscription
الحقول | |
---|---|
name |
مطلوب. |
ListNotificationSubscriptionsRequest
رسالة طلب لطريقة ListNotificationSubscription
الحقول | |
---|---|
parent |
مطلوب. حساب التاجر الذي يملك اشتراكات الإشعارات. التنسيق: |
page_ |
الحد الأقصى لعدد الاشتراكات في الإشعارات التي يتم عرضها في الصفحة القيمة التلقائية لـ |
page_ |
الرمز المميّز (إذا تم توفيره) لاسترداد الصفحة اللاحقة يجب أن تتطابق جميع المَعلمات الأخرى مع الطلب الأصلي الذي قدّم رمز تعريف الصفحة. |
ListNotificationSubscriptionsResponse
رسالة الاستجابة لطريقة ListNotificationSubscription
الحقول | |
---|---|
notification_ |
قائمة الاشتراكات في الإشعارات التي طلبها التاجر |
next_ |
رمز مميّز يمكن إرساله على شكل |
NotificationSubscription
تمثّل اشتراكًا في إشعارات يملكها حساب تاجر.
الحقول | |
---|---|
name |
النتائج فقط. |
registered_ |
الحدث الذي يريد التاجر تلقّي إشعارات بشأنه. |
call_ |
عنوان URL الذي سيتم استخدامه لإرسال الإشعار إلى التاجر. |
حقل الربط يمكن أن يكون |
|
all_ |
إذا كانت هذه القيمة صحيحة، يتم إرسال إشعار إلى الحساب المُرسِل بالحدث المحدّد لجميع الحسابات المُدارة (يمكن أن تكون حسابات فرعية أو حسابات مرتبطة أخرى) بما في ذلك الحسابات المُضافة حديثًا يوميًا. |
target_ |
|
NotificationEventType
يمثّل نوع الحدث الذي يهتم التاجر بتلقّي إشعارات بشأنه.
عمليات التعداد | |
---|---|
NOTIFICATION_EVENT_TYPE_UNSPECIFIED |
نوع حدث الإشعارات غير محدّد. |
PRODUCT_STATUS_CHANGE |
إشعارات بشأن التغييرات في حالة المنتج، مثلاً عندما يصبح المنتج مرفوضًا |
ProductChange
التغيير الذي طرأ على المنتج، بما في ذلك القيمة القديمة والقيمة الجديدة ورقم تعريف البلد كرمز المنطقة وسياق إعداد التقارير
الحقول | |
---|---|
old_ |
القيمة القديمة للمورد أو السمة التي تم تغييرها |
new_ |
القيمة الجديدة للمورد أو السمة التي تم تغييرها |
region_ |
البلدان التي تم فيها إجراء التغيير (إن وُجد) |
reporting_ |
سياقات إعداد التقارير التي تتضمّن التغيير (إن وُجد) |
ProductStatusChangeMessage
الرسالة التي سيتلقّاها التاجر لإعلامه بحدث تغيير حالة المنتج
الحقول | |
---|---|
changes[] |
رسالة لوصف التغيير الذي طرأ على المنتج |
account |
الحساب المستهدَف الذي يملك العنصر الذي تغيّر التنسيق : |
managing_ |
الحساب الذي يدير حساب التاجر. يمكن أن يكون الحساب الإداري هو نفسه معرّف التاجر إذا كان حسابًا مستقلّا. التنسيق : |
resource_ |
المورد الذي تغيّر، وفي هذه الحالة سيكون دائمًا |
attribute |
السمة في المورد التي تغيّرت، وفي هذه الحالة ستكون دائمًا |
resource_ |
معرّف المنتج. |
resource |
اسم المنتج التنسيق: |
expiration_ |
وقت انتهاء صلاحية المنتج. لن يتم ضبط هذا الحقل إذا تم إرسال الإشعار لحدث حذف منتج. |
المورد
فهرس لتحديد المورد الذي يتم تغييره لإعلام التاجر به
عمليات التعداد | |
---|---|
RESOURCE_UNSPECIFIED |
مصدر غير محدّد |
PRODUCT |
نوع المورد : منتج |
UpdateNotificationSubscriptionRequest
رسالة طلب لطريقة UpdateNotificationSubscription
الحقول | |
---|---|
notification_ |
مطلوب. الإصدار الجديد من اشتراك الإشعارات الذي يجب تعديله |
update_ |
قائمة الحقول التي يتم تعديلها |