Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
शुरुआती जानकारी
कमाई करने की सीमाओं की जांच करने से जुड़ी नीति का इस्तेमाल करके, कमाई करने की सीमाएं लागू करना लेख में बताए गए तरीके से, कमाई करने से जुड़ी सीमाएं सेट की जा सकती हैं. अपने-आप मिलने वाली सूचनाओं की सुविधा सेट अप करने का विकल्प भी है. यह सीमा पूरी होने या पूरी होने पर, डेवलपर और/या आपके संगठन के उपयोगकर्ताओं को चेतावनी देती है.
आपके पास कस्टम सीमाओं और इंप्लिसिट लिमिट के लिए, अपने-आप सूचनाएं पाने की सुविधा सेट अप करने का विकल्प है. उदाहरण के लिए, सिस्टम आपके प्रीपेड डेवलपर के लिए इंप्लिसिट लिमिट सेट करता है, जो कि उनका प्रीपेड बैलेंस है. अपने-आप मिलने वाली सूचनाएं पाने की सुविधा सेट अप की जा सकती है, ताकि आपके डेवलपर को उनकी प्रीपेड बकाया रकम पहुंचने की सूचना मिल जाए.
टूलबॉक्स
समय-समय पर सूचनाएं पाने की सुविधा सेट अप करने के लिए, मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) या कमाई करने वाले एपीआई का इस्तेमाल करें. यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने पर, सूचनाएं पेज पर अपने-आप सूचनाएं पाने की सुविधा सेट अप की जाती है.
अगर एपीआई का इस्तेमाल किया जाता है, तो कमाई करने की सुविधा से मिलने वाले सूचना टेंप्लेट में बदलाव करके, सीमा के लिए अपने-आप सूचनाएं पाने की सुविधा सेट अप की जा सकती है. इसके बाद, उस शर्त के बारे में बताएं जिसकी वजह से, बदले गए टेंप्लेट से सूचना भेजी जाएगी.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, सीमा से जुड़ी सूचनाएं सेट अप करना
- सीमा जोड़ें पेज के सूचनाएं सेक्शन में, जोड़ें पर क्लिक करें. इससे, सूचना सेक्शन खुल जाएगा.
- सूचना के लिए कोई लेवल चुनें. यह थ्रेशोल्ड, तय की गई संख्या या समयसीमा के प्रतिशत के हिसाब से तय होता है. चुनें:
- ड्रॉप-डाउन मेन्यू से, ज़्यादा या बराबर का चिह्न (?) या उससे कम या उसके बराबर का चिह्न (?).
- पूरी संख्या (दशमलव के बाद कोई अंक नहीं). निरपेक्ष (किसी संख्या की वैल्यू को दिखाने के लिए) या प्रतिशत वैल्यू दिखाने के लिए प्रतिशत. प्रतिशत की सीमाओं के लिए, हमेशा पक्का करें कि आपने सीमा को > के तौर पर सेट किया हो. इसका मतलब है कि जब डेवलपर उस प्रतिशत के लेवल पर पहुंच जाता है या उसे पार कर लेता है, तो सूचना भेजी जाती है.
उदाहरण के लिए, अगर खर्च की सीमा 100 डॉलर तय की जाती है और सूचना 90% से ज़्यादा या उसके बराबर सेट की जाती है, तो 90% (90 डॉलर) तक खर्च होने या उससे ज़्यादा होने पर सूचना भेजी जाएगी.
- ईमेल भेजें फ़ील्ड में जाकर, एक या उससे ज़्यादा डेवलपर चुनें या अपने संगठन के एक या उससे ज़्यादा उपयोगकर्ता चुनें. जिन डेवलपर या उपयोगकर्ताओं पर इस समस्या का असर हुआ है उन्हें सूचना भेजी जाएगी.
ईमेल पाने वाले: डेवलपर को सूचनाएं सिर्फ़ तब भेजी जा सकती हैं, जब आपने डेवलपर के लिए तय की गई "कोई भी" शर्त सेट की हो या डेवलपर के लिए डेवलपर के इस्तेमाल की सीमा तय की गई हो. अगर आपने "कोई भी" चुना है, तो आपको ईमेल पतों की सूची में "डेवलपर (कोई भी) चुना गया" दिखेगा. इसका मतलब है कि कमाई करने की सुविधा से, उन सभी डेवलपर को इसकी सूचना भेजी जाएगी जिन पर इस समस्या का असर पड़ा है. अगर आपने कोई खास डेवलपर चुना है, तो आपको ईमेल पतों की सूची में (जहां
{developer_id}, चुने गए डेवलपर की पहचान है) में "डेवलपर ({developer_id}) चुना गया" दिखेगा. कमाई करने की सुविधा चालू होने पर, सिर्फ़ उस डेवलपर को सूचना भेजी जाएगी.अगर आपने डेवलपर के लिए तय की गई सीमा की शर्त "कोई भी" या किसी खास डेवलपर को नहीं चुना है, तो आपको ईमेल भेजें फ़ील्ड में "डेवलपर (कोई भी) चुना गया" नहीं दिखेगा. हालांकि, आपके पास यह चुनने का विकल्प है कि आपको अपने संगठन के किन उपयोगकर्ताओं को सूचना देनी है.
आप 'एडमिन' टैब में 'संगठन के उपयोगकर्ता' चुनकर, अपने संगठन के उपयोगकर्ताओं के ईमेल पते जोड़ सकते हैं.
ईमेल टेंप्लेट: ईमेल भेजें फ़ील्ड "चुने गए डेवलपर (कोई भी)" या अपने संगठन के उपयोगकर्ताओं के ईमेल पते (या दोनों) चुनने के बाद, आपको एक ईमेल टेंप्लेट दिखेगा. टेंप्लेट में क्या दिखेगा, यह इन बातों पर निर्भर करता है:
- सूचना का लेवल.
- यह सीमा, रोकने की एक्ज़ीक्यूशन सीमा थी या नहीं.
- ईमेल संगठन के उपयोगकर्ताओं, डेवलपर या दोनों के लिए था.
उदाहरण के लिए, अगर नीचे दी गई सभी बातें सही हैं:
- एक्ज़ीक्यूशन रोकें चेकबॉक्स पर सही का निशान लगा है.
- सूचना का लेवल 100% या तय सीमा के बराबर है.
- यह ईमेल सिर्फ़ संगठन के उपयोगकर्ताओं के लिए है.
टेंप्लेट कुछ ऐसा दिखता है:
मान लें कि डेवलपर की कंपनी का नाम "XYZ कंपनी" है, "X Package" नाम के एपीआई पैकेज और "Y Product" नाम के एक एपीआई प्रॉडक्ट के लिए, लेन-देन वॉल्यूम की सीमा 50 पर सेट है. साथ ही, खत्म होने की तारीख 30 सितंबर, 2013 सेट की गई है. भेजा गया ईमेल मैसेज कुछ ऐसा दिखेगा:
Developer XYZ company has exceeded their transaction volume limit of 50 transactions for X package, Y product. Their API calls will be blocked till 2013-09-30
अगर ईमेल "चुने गए डेवलपर (किसी भी)" के लिए है, तो टेंप्लेट इस तरह दिखता है:
दोनों टेंप्लेट, काम के वैरिएबल का समाधान करेंगे. जैसे, डेवलपर का नाम (अगर लागू हो), पैकेज का नाम (अगर लागू हो), और प्रॉडक्ट का नाम (अगर लागू हो). अपनी ज़रूरतों को पूरा करने के लिए, मैसेज में बदलाव किया जा सकता है. इसके लिए, टेंप्लेट की बाईं ओर मौजूद 'बदलाव करें' पर क्लिक करें.
अगर यह सीमा "कोई भी" या किसी खास ऐप्लिकेशन के लिए है और "कोई भी" या किसी खास उपयोगकर्ता के लिए है, तो आपको टेंप्लेट में ऐप्लिकेशन और उपयोगकर्ता के लिए भी वैरिएबल जोड़ने होंगे. ऐसा करने के लिए, यह तरीका अपनाया जा सकता है:
- टेंप्लेट के बाईं ओर मौजूद, 'बदलाव करें' पर क्लिक करें.
${user.name}user, depending on whether the limit is for application and/or user.
"कोई भी" या किसी खास ऐप्लिकेशन की स्थिति में बदलाव किया गया टेंप्लेट नीचे दिखाया गया है.
अगर रोकें निष्पादन चेक नहीं किया गया है या सूचना का स्तर 100% से ज़्यादा या उसके बराबर है, तो चुने गए डेवलपर के लिए टेंप्लेट कुछ ऐसा दिखता है:
ध्यान दें, अगर यह सीमा "कोई" (या खास) या "कोई" (या कोई खास) उपयोगकर्ता के लिए है, तो आपको टेंप्लेट में बदलाव करना होगा. इसके बाद, आपको
${application.name}ऐप्लिकेशन और/या${user.name}उपयोगकर्ता को जोड़ना होगा. यह इस बात पर निर्भर करता है कि यह सीमा किसी ऐप्लिकेशन के लिए है, उपयोगकर्ता के लिए है या दोनों के लिए है.टेंप्लेट वैरिएबल: ईमेल टेंप्लेट में मैसेज में बदलाव करते समय, इनमें से कोई भी वैरिएबल शामिल किया जा सकता है.
वैरिएबल Description ${developer.name}डेवलपर का नाम.
${developer.legalName}डेवलपर की कंपनी का नाम.
${ratePlan.monetizationPackage.displayName}एपीआई पैकेज का नाम.
${application.name}ऐप्लिकेशन का नाम.
${USER}उपयोगकर्ता का नाम.
${USAGE}मौजूदा इस्तेमाल (कुल रेवेन्यू या शुल्क या वॉल्यूम).
${PERCENT}मौजूदा इस्तेमाल के हिसाब से सीमा का प्रतिशत.
${QUOTA_TYPE}सीमा का टाइप (लेन-देन की संख्या, खर्च की सीमा या शुल्क का एक्सपोज़र).
${QUOTA_UNIT}सीमा के लिए बुनियादी इकाई: मुद्रा (खर्च करने की सीमा के लिए) या कॉल (लेन-देन की सीमा के लिए).
${QUOTA_LIMIT}सीमा की रकम.
${EXPIRY_DATE}वह तारीख या समय जब सीमा खत्म हो जाती है या जब वह रीसेट होती है.
उदाहरण के लिए, अगर आपको किसी डेवलपर के ऐप्लिकेशन पर किसी पैकेज के लिए लेन-देन की संख्या के तय प्रतिशत तक पहुंचने की सूचना चाहिए, तो टेंप्लेट में बदलाव करके उसे कुछ इस तरह दिखाया जा सकता है:
${developer.legalName} has reached a total volume of ${USAGE} on ${ratePlan.monetizationPackage.displayName}. This is ${PERCENT} of the daily/weekly/monthly (state period of limit as appropriate) transaction volume limit of ${QUOTA_LIMIT}. - अतिरिक्त लेवल के लिए, ज़रूरत के मुताबिक सूचनाएं जोड़ें. हर अतिरिक्त लेवल के लिए, 'जोड़ें' पर क्लिक करें. इससे पेज के सूचना सेक्शन में, लेवल, ईमेल भेजें, और ईमेल का टेंप्लेट एरिया जुड़ जाता है. सूचनाओं के लिए, ज़्यादा से ज़्यादा छह लेवल जोड़े जा सकते हैं. उदाहरण के लिए, अगर सूचना को 70%, 80%, 90%, 100% पर सेट किया जाता है, तो इन सभी लेवल पर पहुंचने पर एक सूचना भेजी जाएगी.
- सभी सूचनाएं जोड़ने के बाद, सेव करें (इन्हें बाद की किसी तारीख पर सेव और पब्लिश करने के लिए), सेव और पब्लिश करें (अभी पब्लिश करने के लिए) या रद्द करें (रद्द करने के लिए) पर क्लिक करें.
एपीआई का इस्तेमाल करके, सीमा से जुड़ी सूचनाएं सेट अप करना
कमाई करने की सुविधा, कई तरह की सूचनाओं के लिए टेक्स्ट उपलब्ध कराती है. इनमें, सीमित संख्या से जुड़ी सूचनाएं शामिल होती हैं. साथ ही, इसमें कुछ समय के लिए सूचनाएं भी शामिल होती हैं. जैसे, डेवलपर को नए प्रॉडक्ट की उपलब्धता के बारे में सूचना देना. आपके पास अपनी ज़रूरत के हिसाब से, इनमें से किसी भी टेंप्लेट में बदलाव करने का विकल्प होता है. सूचना पाने की सीमा अपने-आप सेट अप करने के लिए, पहले सही टेंप्लेट में बदलाव करें. इसके बाद, उस शर्त के बारे में बताएं जिसकी वजह से, बदले गए टेंप्लेट से सूचना भेजी जाएगी. ज़्यादा जानकारी के लिए, सूचना टेंप्लेट का इस्तेमाल करके सूचनाएं सेट अप करना देखें.
अगले चरण
अपने-आप सूचनाएं पाने की सुविधा सेट अप करने का तरीका जानें, ताकि आप डेवलपर को नए प्रॉडक्ट, नियमों और शर्तों के नए वर्शन या नए कीमत प्लान जैसे इवेंट के बारे में सूचना दे सकें. सूचना टेंप्लेट का इस्तेमाल करके सूचनाएं सेट अप करना देखें.