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 की खास जानकारी देखें.

एट्रिब्यूट

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

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

CreateNotificationSubscriptionRequest

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

फ़ील्ड
parent

string

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

NotificationSubscription

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

DeleteNotificationSubscriptionRequest

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

फ़ील्ड
name

string

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

GetNotificationSubscriptionRequest

Get NotificationsSubscription तरीके के लिए, अनुरोध वाला मैसेज.

फ़ील्ड
name

string

ज़रूरी है. सूचना पाने के लिए ली गई सदस्यता का name.

ListNotificationSubscriptionsRequest

List NotificationSubscription वाले तरीके के लिए अनुरोध वाला मैसेज है.

फ़ील्ड
parent

string

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

int32

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

string

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

ListNotificationSubscriptionsResponse

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

फ़ील्ड
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}}

संसाधन

व्यापारी/कंपनी को सूचना देने के लिए बदले जा रहे संसाधन की जानकारी देने के लिए Enum.

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

UpdateNotificationSubscriptionRequest

Update NotificationSubscription वाले तरीके के लिए अनुरोध वाला मैसेज.

फ़ील्ड
notification_subscription

NotificationSubscription

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

FieldMask

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