برداشتن همه اعضای مخاطب

این راهنما توضیح می‌دهد که چگونه همه اعضا را از مخاطبان «مطابقت مشتری» با ارسال RemoveAllAudienceMembersRequest حذف کنید.

این روش زمانی مفید است که بخواهید فهرست کاربر را با یک درخواست پاک کنید یا همه اعضای مخاطب یک فهرست را جایگزین کنید.

پاک کردن مخاطب

برای برداشتن همه اعضا از مخاطب، RemoveAllAudienceMembersRequest ارسال کنید و فیلد removeAsOfTime را حذف کنید. با این کار، زمان برداشتن به‌طور پیش‌فرض روی زمان فعلی تنظیم می‌شود، و همه اعضای فعلی از فهرست پاک می‌شوند.

جایگزین کردن همه اعضا

برای جایگزین کردن همه اعضا در مخاطبان «مطابقت مشتری» و درعین‌حال جلوگیری از خالی شدن فهرست کاربران، این مراحل را دنبال کنید:

1. زمان فعلی را به‌صورت T ضبط کنید.
2. بارگذاری اعضای جدید را با ارسال IngestAudienceMembersRequest شروع کنید. درصورت نیاز می‌توانید چندین درخواست جذب ایجاد کنید.

3. صبر کنید تا پردازش همه درخواست‌های انتقال تمام شود. می‌توانید وضعیت درخواست‌هایتان را بااستفاده از تشخیص خرابی بررسی کنید.

4. RemoveAllAudienceMembersRequest را با removeAsOfTime تنظیم‌شده روی مُهر زمان T ثبت‌شده در مرحله ۱ ارسال کنید. با این کار، فقط اعضایی که قبل‌از شروع بارگذاری اعضای جدید اضافه شده‌اند برداشته می‌شوند و فقط اعضای جدید اضافه‌شده باقی می‌مانند.

ساختن درخواست

فیلدهای زیر را در بدنه RemoveAllAudienceMembersRequest تنظیم کنید:

destinations

الزامی. فهرست مقاصد. فیلد productDestinationId در هر مقصد، مخاطبی را که می‌خواهید اعضا را از آن بردارید مشخص می‌کند. برای اطلاعات بیشتر، به پیکربندی مقصدها مراجعه کنید.

removeAsOfTime

اختیاری. فقط اعضایی که قبل‌از این زمان اضافه شده‌اند برداشته خواهند شد. برای جزئیات قالب‌بندی، به قالب مُهر زمان مراجعه کنید. اگر تنظیم نشده باشد، این مقدار به‌طور پیش‌فرض روی زمان فعلی تنظیم می‌شود.

validateOnly

اختیاری. برای اعتبارسنجی درخواست بدون اعمال تغییرات، روی true تنظیم کنید. وقتی آماده اعمال تغییرات بودید، روی false تنظیم کنید.

درخواست‌های نمونه

در اینجا یک درخواست نمونه آورده شده است که همه اعضا را از فهرست «مطابقت مشتری» برمی‌دارد.

1. روی باز کردن در API Explorer کلیک کنید تا API Explorer در برگه یا پنجره جدیدی باز شود.
2. در بدنه درخواست در API Explorer، هر رشته‌ای را که با REPLACE_WITH شروع می‌شود، مثل REPLACE_WITH_OPERATING_ACCOUNT_TYPE، با مقدار مربوطه جایگزین کنید.
3. روی اجرا در پایین صفحه «کاوشگر API» کلیک کنید و پیام‌واره‌های صدور مجوز را برای ارسال درخواست تکمیل کنید.
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"
}

اگر درخواست ناموفق بود، خطاها را بررسی کنید تا علت ناموفق بودن را تعیین کنید.