Package google.shopping.merchant.notifications.v1beta

इंडेक्स

NotificationsApiService

व्यापारियों/कंपनियों/कारोबारियों के लिए, सूचना की सदस्यताएं मैनेज करने की सेवा

CreateNotificationSubscription

rpc CreateNotificationSubscription(CreateNotificationSubscriptionRequest) returns (NotificationSubscription)

किसी कारोबार के लिए सूचना की सदस्यता बनाता है. स्टैंडअलोन या सब-खाते वाले खातों के लिए, कारोबार खुद के लिए सदस्यता बना सकता है. एमसीए के लिए, कारोबार सभी मैनेज किए जा रहे खातों या किसी खास उप-खाते के लिए सदस्यता बना सकता है.

हम सूचना की इन सदस्यताओं को एक साथ मौजूद रहने की अनुमति देंगे (हर इवेंट टाइप के लिए, हर कारोबार के तौर पर सदस्य):

  1. मैनेज किए जा रहे सभी खातों के लिए सदस्यता + खुद के लिए सदस्यता.

  2. मैनेज किए जा रहे खातों के लिए एक से ज़्यादा "कुछ समय के लिए" सदस्यताएं और खुद के लिए सदस्यता.

हम इनकी अनुमति नहीं देंगे:

  1. खुद के लिए ली गई कई सदस्यताएं.

  2. "मैनेज किए जा रहे सभी खातों" की कई सदस्यताएं.

  3. "मैनेज किए जा रहे सभी खातों" की सदस्यता और कुछ खातों की सदस्यता, एक ही समय पर.

  4. एक ही टारगेट खाते के लिए, कई पार्टल सदस्यताएं.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/content

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
DeleteNotificationSubscription

rpc DeleteNotificationSubscription(DeleteNotificationSubscriptionRequest) returns (Empty)

किसी व्यापारी/कंपनी/कारोबारी की सूचना की सदस्यता मिटाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/content

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
GetNotificationSubscription

rpc GetNotificationSubscription(GetNotificationSubscriptionRequest) returns (NotificationSubscription)

किसी खाते के लिए सूचना की सदस्यताएं पाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/content

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
ListNotificationSubscriptions

rpc ListNotificationSubscriptions(ListNotificationSubscriptionsRequest) returns (ListNotificationSubscriptionsResponse)

किसी कारोबारी या कंपनी की सभी सूचनाएं पाने की सदस्यताएं.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/content

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
UpdateNotificationSubscription

rpc UpdateNotificationSubscription(UpdateNotificationSubscriptionRequest) returns (NotificationSubscription)

किसी व्यापारी/कंपनी/कारोबारी की सूचना पाने के लिए ली गई मौजूदा सदस्यता को अपडेट करता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/content

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

एट्रिब्यूट

संसाधन में मौजूद उस एट्रिब्यूट की जानकारी देने के लिए एन्मु, जिसे बदला जा रहा है, ताकि व्यापारी/कंपनी/कारोबारी को इसकी सूचना दी जा सके.

Enums
ATTRIBUTE_UNSPECIFIED एट्रिब्यूट की वैल्यू नहीं दी गई
STATUS बदली गई इकाई की स्थिति

CreateNotificationSubscriptionRequest

CreateNotificationSubscription तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. वह व्यापारी खाता जिसके पास सूचना की नई सदस्यता का मालिकाना हक है. फ़ॉर्मैट: accounts/{account}
notification_subscription

NotificationSubscription

ज़रूरी है. सूचना की वह सदस्यता जिसे बनाना है.

DeleteNotificationSubscriptionRequest

DeleteNotificationSubscription तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
name

string

ज़रूरी है. सूचना की जिस सदस्यता को मिटाना है उसका नाम.

GetNotificationSubscriptionRequest

GetNotificationSubscription तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
name

string

ज़रूरी है. सूचना की सदस्यता का name.

ListNotificationSubscriptionsRequest

ListNotificationSubscription तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. वह व्यापारी/कंपनी खाता जिसके पास सूचना की सदस्यताओं का मालिकाना हक है. फ़ॉर्मैट: accounts/{account}
page_size

int32

किसी पेज पर सूचना की ज़्यादा से ज़्यादा सदस्यताएं दिखाने की संख्या. page_size की डिफ़ॉल्ट वैल्यू 100 है. ज़्यादा से ज़्यादा 200 हो सकती है. 200 से ज़्यादा की वैल्यू को 200 पर सेट कर दिया जाएगा.
page_token

string

अगला पेज पाने के लिए टोकन (अगर दिया गया हो). अन्य सभी पैरामीटर, उस ओरिजनल कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया था.

ListNotificationSubscriptionsResponse

ListNotificationSubscription तरीके के लिए रिस्पॉन्स मैसेज.

फ़ील्ड
notification_subscriptions[]

NotificationSubscription

सूचना की उन सदस्यताओं की सूची जिनका अनुरोध व्यापारी/कंपनी ने किया है.
next_page_token

string

एक टोकन, जिसे अगले पेज को वापस पाने के लिए page_token के तौर पर भेजा जा सकता है. अगर इस फ़ील्ड को छोड़ा जाता है, तो इसके बाद कोई पेज नहीं दिखेगा.

NotificationSubscription

किसी व्यापारी/कंपनी/कारोबारी के खाते के मालिकाना हक वाली सूचना की सदस्यता दिखाता है.

फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. सूचना कॉन्फ़िगरेशन का name. नया NotificationSubscription बनाने पर, Content API से जनरेट होता है. account, कॉन्फ़िगरेशन के मालिक कारोबारी या कंपनी का मर्चेंट आईडी दिखाता है. फ़ॉर्मैट: accounts/{account}/notificationsubscriptions/{notification_subscription}
registered_event

NotificationEventType

वह इवेंट जिसके बारे में व्यापारी/कंपनी को सूचना चाहिए.
call_back_uri

string

व्यापारी/कंपनी/कारोबारी को सूचना भेजने के लिए इस्तेमाल किया जाने वाला यूआरएल.

यूनियन फ़ील्ड interested_in.

interested_in इनमें से कोई एक हो सकता है:
all_managed_accounts

bool

अगर यह वैल्यू 'सही' पर सेट है, तो अनुरोध करने वाले खाते को मैनेज किए जा रहे सभी खातों (ये सब-खाते या लिंक किए गए अन्य खाते हो सकते हैं) के लिए, तय किए गए इवेंट की सूचना हर दिन दी जाती है. इसमें, नए जोड़े गए खाते भी शामिल हैं.
target_account

string

उस खाते का name जिससे आपको सूचनाएं चाहिए. फ़ॉर्मैट: accounts/{account}

NotificationEventType

इस एट्रिब्यूट से उस इवेंट टाइप के बारे में पता चलता है जिसके लिए व्यापारी/कंपनी को सूचनाएं चाहिए.

Enums
NOTIFICATION_EVENT_TYPE_UNSPECIFIED सूचनाओं के इवेंट टाइप की जानकारी नहीं दी गई है.
PRODUCT_STATUS_CHANGE प्रॉडक्ट के स्टेटस में हुए बदलावों की सूचना. उदाहरण के लिए, जब प्रॉडक्ट अस्वीकार कर दिया जाता है.

ProductChange

प्रॉडक्ट में हुआ बदलाव. इसमें पुरानी वैल्यू, नई वैल्यू, देश कोड को क्षेत्र कोड के तौर पर, और रिपोर्टिंग के संदर्भ में जानकारी शामिल है.

फ़ील्ड
old_value

string

बदले गए संसाधन या एट्रिब्यूट की पुरानी वैल्यू.
new_value

string

बदले गए संसाधन या एट्रिब्यूट की नई वैल्यू.
region_code

string

वे देश जहां बदलाव हुआ है (अगर लागू हो)
reporting_context

ReportingContextEnum

रिपोर्टिंग के ऐसे कॉन्टेक्स्ट जिनमें बदलाव हुआ है (अगर लागू हो)

ProductStatusChangeMessage

प्रॉडक्ट की स्थिति में हुए बदलाव के बारे में सूचना देने के लिए, व्यापारी/कंपनी/कारोबारी को मिलने वाला मैसेज

फ़ील्ड
changes[]

ProductChange

प्रॉडक्ट में हुए बदलाव के बारे में बताने वाला मैसेज
account

string

टारगेट खाता, जिसके पास बदली गई इकाई का मालिकाना हक है. फ़ॉर्मैट : accounts/{merchant_id}
managing_account

string

यह वह खाता होता है जो व्यापारी/कंपनी/कारोबारी के खाते को मैनेज करता है. अगर यह स्टैंडअलोन खाता है, तो यह मर्चेंट आईडी से मेल खा सकता है. फ़ॉर्मैट : accounts/{service_provider_id}
resource_type

Resource

बदला गया संसाधन, इस मामले में यह हमेशा Product होगा.
attribute

Attribute

रिसॉर्स में बदला गया एट्रिब्यूट, इस मामले में यह हमेशा Status होगा.
resource_id

string

प्रॉडक्ट आईडी.
resource

string

प्रॉडक्ट का नाम. फ़ॉर्मैट: {product.name=accounts/{account}/products/{product}}
expiration_time

Timestamp

प्रॉडक्ट की समयसीमा खत्म होने का समय. अगर प्रॉडक्ट मिटाने के इवेंट के लिए सूचना भेजी जाती है, तो यह फ़ील्ड सेट नहीं होगा.

संसाधन

उस संसाधन की जानकारी देने के लिए एन्म् (Enum), जिसमें बदलाव किया जा रहा है, ताकि व्यापारी/कंपनी/कारोबारी को इसकी सूचना दी जा सके.

Enums
RESOURCE_UNSPECIFIED ऐसा संसाधन जिसके बारे में जानकारी नहीं दी गई है
PRODUCT रिसॉर्स टाइप : प्रॉडक्ट

UpdateNotificationSubscriptionRequest

UpdateNotificationSubscription के तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
notification_subscription

NotificationSubscription

ज़रूरी है. सूचना पाने के लिए ली गई सदस्यता का नया वर्शन, जिसे अपडेट करना है.
update_mask

FieldMask

अपडेट किए जा रहे फ़ील्ड की सूची.