किसी ऑडियंस से सभी सदस्यों को हटाना

इस गाइड में, RemoveAllAudienceMembersRequest भेजकर, कस्टमर मैच ऑडियंस से सभी सदस्यों को हटाने का तरीका बताया गया है.

यह तरीका तब काम आता है, जब आपको एक ही अनुरोध से उपयोगकर्ता सूची को मिटाना हो या किसी सूची के सभी सदस्यों को बदलना हो.

ऑडियंस हटाना

किसी ऑडियंस से सभी सदस्यों को हटाने के लिए, RemoveAllAudienceMembersRequest भेजें और removeAsOfTime फ़ील्ड को छोड़ दें. इससे, हटाने का समय डिफ़ॉल्ट रूप से मौजूदा समय पर सेट हो जाता है. साथ ही, सूची से सभी मौजूदा सदस्यों को हटा दिया जाता है.

सभी सदस्यों को बदलना

कस्टमर मैच ऑडियंस के सभी सदस्यों को बदलने के लिए, यह तरीका अपनाएं. इससे, उपयोगकर्ताओं की सूची खाली नहीं रहेगी:

1. मौजूदा समय को T के तौर पर रिकॉर्ड करें.
2. IngestAudienceMembersRequest भेजकर, नए सदस्यों को अपलोड करना शुरू करें. ज़रूरत पड़ने पर, डेटा डालने के लिए कई अनुरोध किए जा सकते हैं.

3. डेटा डालने के सभी अनुरोधों की प्रोसेस पूरी होने तक इंतज़ार करें. डाइग्नोस्टिक्स का इस्तेमाल करके, अपने अनुरोधों की स्थिति देखी जा सकती है.

4. RemoveAllAudienceMembersRequest भेजें. इसमें removeAsOfTime को पहले चरण में रिकॉर्ड किए गए टाइमस्टैंप T पर सेट करें. इससे सिर्फ़ वे सदस्य हटते हैं जिन्हें नए सदस्यों को अपलोड करने से पहले जोड़ा गया था. इससे सिर्फ़ नए जोड़े गए सदस्य ही बचते हैं.

अनुरोध तैयार करना

RemoveAllAudienceMembersRequest बॉडी में ये फ़ील्ड सेट करें:

destinations

ज़रूरी है. डेस्टिनेशन की सूची. हर डेस्टिनेशन में मौजूद productDestinationId फ़ील्ड से, उस ऑडियंस के बारे में पता चलता है जिससे आपको सदस्यों को हटाना है. ज़्यादा जानकारी के लिए, डेस्टिनेशन कॉन्फ़िगर करना लेख पढ़ें.

removeAsOfTime

ज़रूरी नहीं. सिर्फ़ उन सदस्यों को हटाया जाएगा जिन्हें इस समय से पहले जोड़ा गया था. फ़ॉर्मैटिंग की जानकारी के लिए, टाइमस्टैंप का फ़ॉर्मैट देखें. अगर यह वैल्यू सेट नहीं की जाती है, तो डिफ़ॉल्ट रूप से मौजूदा समय को ही इसकी वैल्यू मान लिया जाता है.

validateOnly

ज़रूरी नहीं. बदलावों को लागू किए बिना अनुरोध की पुष्टि करने के लिए, true पर सेट करें. जब आप बदलाव लागू करने के लिए तैयार हों, तो false पर सेट करें.

सैंपल के लिए अनुरोध

यहां एक सैंपल अनुरोध दिया गया है, जो कस्टमर मैच की सूची से सभी सदस्यों को हटा देता है.

1. एपीआई एक्सप्लोरर को नए टैब या विंडो में खोलने के लिए, एपीआई एक्सप्लोरर में खोलें पर क्लिक करें.
2. एपीआई एक्सप्लोरर में अनुरोध के मुख्य हिस्से में, REPLACE_WITH से शुरू होने वाली हर स्ट्रिंग को काम की वैल्यू से बदलें. जैसे, REPLACE_WITH_OPERATING_ACCOUNT_TYPE.
3. API Explorer पेज पर सबसे नीचे मौजूद, Execute पर क्लिक करें. इसके बाद, अनुरोध भेजने के लिए अनुमति देने के प्रॉम्प्ट को पूरा करें.
4. बदलावों को लागू किए बिना अनुरोध की पुष्टि करने के लिए, validateOnly को true पर सेट करें. जब आप बदलाव लागू करने के लिए तैयार हों, तो validateOnly को false पर सेट करें.

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "LOGIN_ACCOUNT_TYPE",
                "accountId": "LOGIN_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "DATA_PARTNER",
                "accountId": "DATA_PARTNER_ACCOUNT_ID"
            },
            "linkedAccount": {
                "accountType": "LINKED_ACCOUNT_TYPE",
                "accountId": "LINKED_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

अनुरोध भेजें

अनुरोध को removeAll एंडपॉइंट पर भेजें.

अगर अनुरोध पूरा हो जाता है, तो जवाब में requestId शामिल होता है. इसका इस्तेमाल करके, कार्रवाई की स्थिति को ट्रैक किया जा सकता है.

{
  "requestId": "REQUEST_ID"
}

अगर अनुरोध पूरा नहीं हो पाता है, तो गड़बड़ी की वजह जानने के लिए गड़बड़ियों की जांच करें.