फ़ीड का अवलोकन

इस सेक्शन में, Actions Center के साथ इंटिग्रेशन के तीन मुख्य हिस्सों के बारे में ज़्यादा जानकारी दी गई है. इनमें से हर हिस्से का इस्तेमाल, एंड-टू-एंड गाइड में बताए गए चरणों में किया जाएगा.

फ़ीड

फ़ीड `JSON` या pb3 फ़ॉर्मैट वाली फ़ाइलें होती हैं. इनका इस्तेमाल, Actions Center को इन्वेंट्री डेटा भेजने के लिए किया जाता है. इससे, एसएफ़टीपी अपलोड का इस्तेमाल करके, एक साथ अपना सारा डेटा सबमिट किया जा सकता है. साथ ही, व्यापारियों, सेवाओं, और उपलब्धता के स्लॉट को अपडेट किया जा सकता है.

Maps Booking API

Maps Booking API की मदद से, फ़ीड सबमिट करने के बीच Actions Center सिस्टम में मौजूद ऑब्जेक्ट को अपडेट किया जा सकता है. इससे, जानकारी को अप-टू-डेट रखा जा सकता है. इस एपीआई की मदद से, Reserve with Google के एंड-टू-एंड इंटिग्रेशन के ज़रिए की गई बुकिंग को भी रद्द किया जा सकता है.

रीयल टाइम में अपडेट की सुविधा, REST कॉल का इस्तेमाल करके लागू की जाती है.

ध्यान दें: रीयल टाइम में अपडेट की सुविधा, शुरुआती इंटिग्रेशन के लिए बहुत कम लागू होती है. शुरुआती इंटिग्रेशन के लिए, Maps Booking API को अनदेखा किया जा सकता है.

ध्यान दें: कुछ मौजूदा पुराने इंटिग्रेशन, आरपीसी कॉल का इस्तेमाल कर रहे हैं. इन्हें अब भी बनाए रखा गया है, लेकिन नए इंटिग्रेशन के लिए इनका इस्तेमाल नहीं किया जाना चाहिए.

बुकिंग सर्वर

Actions Center के एंड-टू-एंड इंटिग्रेशन को आपकी ओर से बुकिंग करने की अनुमति देने के लिए, आपको एक बुकिंग सर्वर सेट अप करना होगा.

ध्यान दें: यह शुरुआती इंटिग्रेशन के लिए लागू नहीं होता है.

REST API

एपीआई का v3 वर्शन इसका सबसे नया वर्शन है. यह REST पर आधारित इंटरफ़ेस के साथ काम करता है. सभी नए इंटिग्रेशन के लिए, v3 एपीआई का इस्तेमाल किया जाना चाहिए.

इस सेक्शन में, Actions Center को इन्वेंट्री डेटा भेजने के लिए इस्तेमाल की जाने वाली फ़ीड फ़ाइलों के बारे में बताया गया है. फ़ीड के कॉन्टेंट से यह तय होता है कि आप कौनसी सेवाएं दे रहे हैं, कौनसी सेवाएं उपलब्ध हैं, और सेवाएं कब उपलब्ध हैं.

इन फ़ीड को हमारे साथ शेयर करने का तरीका जानने के लिए, रेफ़रंस और सैंपल ऐकोर्डियन देखें.

इन्वेंट्री फ़ीड का स्ट्रक्चर, Google Maps Booking API से तय होता है.

किसी भी इंटिग्रेशन के लिए, यह फ़ीड ज़रूरी है:

• व्यापारियों की फ़ीड: इसमें आपके व्यापारियों के बारे में जानकारी होती है.

इसके अलावा, एंड-टू-एंड इंटिग्रेशन के लिए, ये दो फ़ीड ज़रूरी हैं.

• सेवाओं की फ़ीड: इसमें आपके व्यापारियों की ओर से दी जाने वाली सेवाओं के बारे में जानकारी होती है.
• उपलब्धता की फ़ीड: इसमें आपके व्यापारियों की ओर से दी जाने वाली सेवाओं के लिए, उपलब्धता के स्लॉट की सूची होती है.

ध्यान दें: सभी फ़ीड, processing_instruction PROCESS_AS_COMPLETE के साथ अपलोड की जानी चाहिए. PROCESS_AS_INCREMENTAL को बंद कर दिया गया है. इसका इस्तेमाल नहीं किया जा सकता .

इन फ़ीड में कुछ फ़ील्ड ज़रूरी हैं, जबकि कुछ फ़ील्ड ज़रूरी नहीं हैं. ज़रूरी नहीं के तौर पर मार्क किए गए किसी भी फ़ील्ड को खाली होने पर, फ़ीड से हटाया जा सकता है.

फ़ीड के फ़ॉर्मैट के बारे में, प्रोटोकॉल बफ़र 3 सिंटैक्स का इस्तेमाल करके बताया गया है. आपके पास, pb3 फ़ॉर्मैट में प्रोटोकॉल बफ़र डेटा के बाइनरी सीरियलाइज़ेशन या उससे बनाए गए JSON फ़ॉर्मैट में, फ़ीड फ़ाइल अपलोड करने का विकल्प होता है. हमारा सुझाव है कि फ़ीड को JSON फ़ॉर्मैट में अपलोड करें.

हमारा सुझाव है कि अपलोड करने से पहले, gzip का इस्तेमाल करके फ़ीड को कंप्रेस करें.

यह गाइड, Actions Center के प्रोटोकॉल बफ़र के बारे में है. pb3 फ़ाइल जनरेट करने के लिए, प्रोटोकॉल बफ़र का इस्तेमाल करने के तरीके के बारे में सामान्य जानकारी के लिए, यहां Java में एक उदाहरण दिया गया है.