항목 업데이트 보내기

항목 업데이트를 보내려면 /{catalog_id}/batch 엔드포인트를 사용하세요.

카탈로그에서 항목을 만들거나, 업데이트하거나, 삭제하려면 다음으로 HTTP POST 호출을 보내세요.

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>

매개변수

/{catalog_id}/batch/{catalog_id}/items_batch에 대한 매개변수 이름은 유사해 보이지만 각각 다른 매개변수입니다.

/{catalog_id}/items_batch API가 더 많은 사용 사례를 지원하고 적극적으로 관리되고 있으므로 이를 사용하는 것이 좋습니다.

매개변수 유형 설명

allow_upsert

부울

allow_upsertfalse일 경우 카탈로그에 존재하지 않는 품목에 대한 업데이트 요청은 완료되지 않습니다. 그러지 않으면 새 품목이 생성됩니다.

requests

개체

모든 요청을 포함한 JSON 개체.

requests.data

개체

항목에 대한 필드와 값을 포함하는 JSON 개체입니다.

  • 메서드가 CREATE일 경우 이 개체에는 모든 필수 필드가 포함되어야 합니다.
  • 메서드가 UPDATE일 경우 모든 필드를 포함할 수 있습니다.

참고: 전달 가능한 지원되는 필드를 참조하세요.

requests.method

문자열

CREATE, UPDATE, DELETE

requests.retailer_id

문자열

FBID가 아니라 광고주가 제공한 항목의 id입니다.

UPDATE 메서드는 품목이 존재하지 않는 경우 품목을 만드는 데 사용할 수도 있습니다.

자세한 내용은 API 참고 자료를 참조하세요.

제한 사항

  • requests 매개변수에는 업데이트를 5,000개까지 포함할 수 있습니다.
  • 각 카탈로그에 대해 카탈로그 배치의 비즈니스 사용 사례 사용 제한 공식에서 정의한 시간당 횟수만큼 호출할 수 있습니다. 부족할 경우에는 Facebook으로 문의하세요.
  • 배치 크기 제한은 5,000개입니다.
  • "Please reduce the amount of data you're asking for, then retry your request" 메시지가 포함된 오류 코드 1은 API 요청에서 수신한 데이터 용량(바이트)이 너무 크다는 것을 의미합니다. 이 문제를 해결하려면 배치에서 항목 수를 줄이고 다시 시도하세요. 이렇게 하면 요청이 허용 가능한 용량 제한 내에 있어 처리될 수 있습니다.

지원되는 필드

/{catalog_id}/batch 엔드포인트에 지원되는 필드의 리스트를 참조하세요.