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

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

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

ऑडियंस को हटाना

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

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

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

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

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

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

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

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

destinations

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

removeAsOfTime

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

validateOnly

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

अनुरोध के उदाहरण

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

1. एपीआई एक्सप्लोरर को नए टैब या विंडो में खोलने के लिए, एपीआई एक्सप्लोरर में खोलें पर क्लिक करें.
2. API Explorer में अनुरोध के मुख्य भाग में, 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"
}

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