यह Apigee Edge के दस्तावेज़ हैं.
पर जाएं
Apigee X दस्तावेज़. info
परिचय
मुद्रीकरण से जुड़ी सीमाएं सेट की जा सकती हैं. इनके बारे में, मुद्रीकरण की सीमाओं की जांच करने की नीति का इस्तेमाल करके, मुद्रीकरण की सीमाओं को लागू करना लेख में बताया गया है. इसके अलावा, अपने-आप सूचनाएं पाने की सुविधा भी सेट अप की जा सकती है. इससे, सीमा के करीब पहुंचने या सीमा पूरी होने पर, डेवलपर, और/या आपके संगठन के उपयोगकर्ताओं को सूचनाएं मिलती हैं.
कस्टम सीमाओं के साथ-साथ, डिफ़ॉल्ट सीमाओं के लिए भी, अपने-आप सूचनाएं पाने की सुविधा सेट अप की जा सकती है. उदाहरण के लिए, सिस्टम, प्रीपेड वाले डेवलपर के लिए डिफ़ॉल्ट सीमा सेट करता है. यह सीमा, उनके प्रीपेड बैलेंस के बराबर होती है. अपने-आप सूचनाएं पाने की सुविधा सेट अप की जा सकती है, ताकि डेवलपर को उनके प्रीपेड बैलेंस के करीब पहुंचने या पूरा होने पर सूचना मिल जाए.
टूलबॉक्स
मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) या मुद्रीकरण एपीआई का इस्तेमाल करके, सीमाओं के लिए अपने-आप सूचनाएं पाने की सुविधा सेट अप की जा सकती है. यूआई का इस्तेमाल करने पर, सूचनाएं पेज पर जाकर, अपने-आप सूचनाएं पाने की सुविधा सेट अप की जा सकती है.
एपीआई का इस्तेमाल करने पर, मुद्रीकरण की ओर से दिए गए सूचना के टेंप्लेट में बदलाव करके, सीमाओं के लिए अपने-आप सूचनाएं पाने की सुविधा सेट अप की जा सकती है. इसके बाद, वह शर्त तय करें जिसके पूरा होने पर, बदले गए टेंप्लेट से सूचना भेजी जाती है.
यूआई का इस्तेमाल करके, सीमाओं से जुड़ी सूचनाएं सेट अप करना
- सीमा जोड़ें पेज के सूचनाएं सेक्शन में, जोड़ें पर क्लिक करें. इससे, सूचनाएं
सेक्शन खुलता है.
- सूचना के लिए कोई लेवल चुनें. यह सीमा के आधार पर, किसी तय संख्या या
प्रतिशत के आधार पर तय की गई थ्रेशोल्ड होती है. इनमें से कोई एक विकल्प चुनें:
- ड्रॉप-डाउन मेन्यू से, इससे ज़्यादा या इसके बराबर (?) या इससे कम या इसके बराबर (?) का निशान.
- कोई पूर्णांक (यानी, दशमलव के बाद कोई अंक नहीं). कोई संख्या वैल्यू दिखाने के लिए, तय संख्या या प्रतिशत वैल्यू दिखाने के लिए, प्रतिशत. प्रतिशत में तय की गई सीमाओं के लिए, हमेशा पक्का करें कि सीमा को >, पर सेट किया गया हो. इसका मतलब है कि डेवलपर के उस प्रतिशत लेवल तक पहुंचने या उसे पार करने पर, सूचना भेजी जाती है.
उदाहरण के लिए, अगर आपने खर्च की सीमा 100 डॉलर सेट की है और सूचना को 90% या इससे ज़्यादा पर सेट किया है, तो सीमा का 90% (90 डॉलर) पूरा होने या उससे ज़्यादा खर्च होने पर, सूचना भेजी जाएगी.
- ईमेल भेजें फ़ील्ड में, एक या उससे ज़्यादा डेवलपर चुनें या अपने संगठन के एक या उससे ज़्यादा उपयोगकर्ता चुनें. जिन डेवलपर या उपयोगकर्ताओं पर असर पड़ा है उन्हें सूचना भेजी जाएगी.
ईमेल पाने वाले लोग: डेवलपर को सूचनाएं सिर्फ़ तब भेजी जा सकती हैं, जब आपने "कोई भी" डेवलपर के लिए सीमा की शर्त सेट की हो या किसी खास डेवलपर के लिए सीमा की शर्त सेट की हो. "कोई भी" चुनने पर, आपको ईमेल पतों की सूची में ईमेल पते "चुने गए डेवलपर (कोई भी)" दिखेंगे. इसका मतलब है कि मुद्रीकरण, जिन डेवलपर पर असर पड़ा है उन्हें सूचना भेजेगा. किसी खास डेवलपर को चुनने पर, आपको ईमेल पतों की सूची में "चुने गए डेवलपर (
{developer_id})" दिखेगा. यहां{developer_id}चुने गए डेवलपर की पहचान है. मुद्रीकरण सूचना सिर्फ़ उस खास डेवलपर को भेजेगा.अगर आपने "कोई भी" डेवलपर के लिए सीमा की शर्त या किसी खास डेवलपर को नहीं चुना है, तो आपको 'ईमेल भेजें' फ़ील्ड में "चुने गए डेवलपर (कोई भी)" नहीं दिखेगा. हालांकि, यह चुना जा सकता है कि आपको अपने संगठन के किन उपयोगकर्ताओं को सूचना भेजनी है.
एडमिन टैब में, संगठन के उपयोगकर्ता चुनकर, अपने संगठन के उपयोगकर्ताओं के लिए ईमेल पते जोड़े जा सकते हैं.
ईमेल के टेंप्लेट: 'ईमेल भेजें' फ़ील्ड में "चुने गए डेवलपर (कोई भी)" या अपने संगठन के उपयोगकर्ताओं के ईमेल पते (या दोनों) चुनने के बाद, आपको एक ईमेल टेंप्लेट दिखेगा. टेंप्लेट में क्या दिखता है, यह इन बातों पर निर्भर करता है:
- सूचना का लेवल.
- सीमा, टास्क को रोकने वाली सीमा थी या नहीं.
- ईमेल, संगठन के उपयोगकर्ताओं, डेवलपर या दोनों के लिए था.
उदाहरण के लिए, अगर ये सभी बातें सही हैं:
- टास्क को रोकें चेकबॉक्स पर सही का निशान लगा है.
- सूचना का लेवल 100% है या सीमा के बराबर है.
- ईमेल सिर्फ़ संगठन के उपयोगकर्ताओं के लिए है.
टेंप्लेट ऐसा दिखता है:
मान लें कि डेवलपर की कंपनी का नाम "XYZ company" है, "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}उपयोगकर्ता जोड़ना होगा. यह इस बात पर निर्भर करता है कि सीमा, ऐप्लिकेशन, उपयोगकर्ता या दोनों के लिए है या नहीं.टेम्पलेट वैरिएबल: ईमेल टेम्पलेट में मैसेज में बदलाव करते समय, इनमें से कोई भी वैरिएबल शामिल किया जा सकता है.
वैरिएबल ब्यौरा ${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% पर सेट किया जाता है, तो इनमें से हर लेवल पूरा होने पर, सूचना भेजी जाएगी.
- सभी सूचनाएं जोड़ने के बाद, सेव करें (सूचनाओं को सेव करने और बाद में पब्लिश करने के लिए) सेव करें और पब्लिश करें (अभी पब्लिश करने के लिए) या रद्द करें (रद्द करने के लिए) पर क्लिक करें.
एपीआई का इस्तेमाल करके, सीमाओं से जुड़ी सूचनाएं सेट अप करना
मुद्रीकरण, टेंप्लेट का एक सेट उपलब्ध कराता है. इसमें, अलग-अलग तरह की सूचनाओं के लिए टेक्स्ट दिया जाता है. इनमें, सीमाओं से जुड़ी सूचनाएं और ऐड-हॉक सूचनाएं शामिल होती हैं. जैसे, डेवलपर को नए प्रॉडक्ट की उपलब्धता के बारे में सूचना देना. इनमें से किसी भी टेंप्लेट को अपनी ज़रूरतों के हिसाब से बनाया जा सकता है. सीमाओं से जुड़ी सूचनाएं अपने-आप पाने की सुविधा सेट अप करने के लिए, सबसे पहले किसी काम के टेंप्लेट में बदलाव करें. इसके बाद, वह शर्त तय करें जिसके पूरा होने पर, बदले गए टेंप्लेट से सूचना भेजी जाती है. ज़्यादा जानकारी के लिए, सूचनाओं के टेंप्लेट का इस्तेमाल करके सूचनाएं सेट अप करना लेख पढ़ें.
अगले चरण
अपने-आप सूचनाएं पाने की सुविधा सेट अप करने का तरीका जानें, ताकि डेवलपर को नए प्रॉडक्ट, टीऐंडसी के नए वर्शन या नए रेट प्लान जैसे इवेंट के बारे में सूचनाएं दी जा सकें. सूचनाओं के टेंप्लेट का इस्तेमाल करके सूचनाएं सेट अप करना लेख पढ़ें.