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

इस गाइड में, 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 एक्सप्लोरर पेज पर सबसे नीचे मौजूद, 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"
}

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