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

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

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

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

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

सभी सदस्यों को बदलें

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

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

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

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

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

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

destinations

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

removeAsOfTime

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

validateOnly

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

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

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

1. API एक्सप्लोरर को नए टैब या विंडो में खोलने के लिए, API एक्सप्लोरर में खोलें पर क्लिक करें.
2. API Explorer में अनुरोध के मुख्य भाग में, REPLACE_WITH से शुरू होने वाली हर स्ट्रिंग को बदलें. जैसे, REPLACE_WITH_OPERATING_ACCOUNT_TYPE को काम की वैल्यू से बदलें.
3. अनुरोध भेजने के लिए, API एक्सप्लोरर पेज पर सबसे नीचे मौजूद 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"
}

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