판매자 삭제

이 페이지에서는 Facebook 담당자가 지정되어 있는 파트너 광고에서 판매자를 삭제하는 방법을 안내합니다.

참고: Marketplace 또는 판매점을 통해 제품을 판매하는 비즈니스를 가리켜 판매자라고 합니다. Facebook 담당자가 지정되어 있는 파트너 광고로 판매자를 온보딩하면, 해당 판매자는 Facebook 담당자가 지정되어 있는 파트너로 간주됩니다. 편의상 이 페이지에서는 '판매자'를 Facebook 담당자가 지정되어 있는 파트너(즉, 온보딩한 판매자)를 지칭하는 목적으로도 사용합니다.

판매자 삭제 API는 광고 계정을 비활성화하고 다음을 포함하여 온보딩 중에 만든 모든 자산을 삭제합니다.

• 카탈로그 세그먼트
• 페이지
• 시스템 사용자
• 비즈니스

시작하기 전에

판매자를 삭제하기 전에 다음 단계를 완료하세요.

1. 관리자 시스템 사용자 만들기
2. 관리자 시스템 사용자에게 권한 할당
3. 관리자 시스템 사용자의 액세스 토큰 생성
4. 판매자 온보딩
5. appsecret_proof 생성

필수 권한

판매자 삭제 API를 호출하려면 다음과 같은 권한이 필요합니다.

• 비즈니스 관리자
• 크레딧 관리
• 앱 개발자

판매자 삭제 API 호출

요청

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "DELETE", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses?child_business_external_id=<VENDOR_ID>", 
        "name": "<ASYNC_SESSION_NAME>"
      } 
  ]' \
  -F "appsecret_proof=<APP_SECRET>" \
  "https://graph.facebook.com/v20.0"

API 호출 응답은 ASYNC_SESSION_ID와 함께 즉시 반환됩니다. 요청을 계속 처리하는 동안 터미널 상태 [COMPLETED|FAILED]에 도달할 때까지 ASYNC_SESSION_ID를 폴링해야 합니다.

매개변수

응답

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

ASYNC_SESSION_ID를 사용하여 Facebook 담당자가 지정되어 있는 파트너 광고에서 판매자 삭제 상태를 가져옵니다.

자세한 내용은 응답을 얻기 위해 비동기식 세션을 폴링하는 방법을 참조하세요.

성공 응답

상태가 COMPLETED일 경우 비동기식 세션을 폴링한 후의 결과 데이터는 다음과 같습니다.

{
  "result": "{\"id\":\"<MANAGED_PARTNER_BM_ID>\", \"success\":true}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

실패 응답

상태가 FAILED일 경우 비동기식 세션을 폴링한 후의 결과 데이터는 다음과 같습니다.

오류 코드

판매자 삭제 API로 보낸 요청의 결과로 여러 가지 오류 응답이 반환될 수 있습니다. 자세한 내용은 오류를 처리하는 방법을 참조하세요.

더 보기

• 판매자 자격 확인
• 판매자 온보딩
• 응답을 얻기 위해 비동기식 세션을 폴링하는 방법
• 오류 처리 가이드