किसी ऑडियंस में एक साथ कई संपर्क जोड़ें
पते के आधार पर, एक ही कॉल में 200 तक संपर्कों को एक ऑडियंस में डालता है। एकल जोड़ की तरह यह वे पते लेता है जो पहले से वर्कस्पेस की पुस्तिका में हैं और कभी संपर्क नहीं बनाता: जो पता संपर्क नहीं है वह `missing` में लौटता है और उसके लिए कुछ नहीं लिखा जाता, जबकि कॉल का बाक़ी हिस्सा फिर भी पूरा होता है।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
POST /audiences/{id}/contacts/batch
पते के आधार पर, एक ही कॉल में 200 तक संपर्कों को एक ऑडियंस में डालता है। एकल जोड़ की तरह यह वे पते लेता है जो पहले से वर्कस्पेस की पुस्तिका में हैं और कभी संपर्क नहीं बनाता: जो पता संपर्क नहीं है वह missing में लौटता है और उसके लिए कुछ नहीं लिखा जाता, जबकि कॉल का बाक़ी हिस्सा फिर भी पूरा होता है।
उदाहरण
audiences:write चाहिए। emails में 1 से 200 पते होते हैं, जिन्हें मिलान से पहले ट्रिम और छोटे अक्षरों में किया जाता है।
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "added": 1, "unchanged": 1, "missing": ["[email protected]"]}added नई सदस्यताएँ गिनता है, unchanged वे संपर्क जो पहले से ऑडियंस में थे, और missing उन पतों को सूचीबद्ध करता है जो संपर्क नहीं हैं, छोटे अक्षरों में और बिना दोहराव के। उन्हें POST /contacts से सहेजें, या POST /audiences/{id}/import को भेजें, जो उन्हें बनाता है।
दोबारा चलाना सुरक्षित है। वैसी ही दूसरी कॉल कुछ नहीं जोड़ती और सबको unchanged बताती है। डिफ़ॉल्ट ऑडियंस में जोड़ने पर हमेशा added: 0 मिलता है, क्योंकि हर संपर्क पहले से उसमें है।
खाली emails, 200 से ज़्यादा पते या बॉडी में कोई और कुंजी 422 देती है, और कुछ नहीं लिखा जाता।