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

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

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

ऑडियंस को साफ़ करना

किसी ऑडियंस से सभी सदस्यों को हटाने के लिए, a RemoveAllAudienceMembersRequest भेजें और the 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. अनुरोध भेजने के लिए, एपीआई एक्सप्लोरर पेज पर सबसे नीचे मौजूद अनुरोध भेजें पर क्लिक करें और अनुमति से जुड़े प्रॉम्प्ट पूरे करें.
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"
}

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