Listings APIListings API
로그인
POST/api/v4/locations/photos/remove

사업장에서 사진 제거

미디어 ID를 사용하여 사업장에서 하나 이상의 미디어 파일 연결을 해제합니다.

API 키가 필요합니다. 헤더 형식과 키 교체는 인증을 참고하세요.

매개변수

본문

이름유형필수설명
input.locationIdstring필수The location's Base64-encoded Relay ID the photos belong to.
input.photoIdsarray of strings필수Media file IDs to detach from the location (as returned by the get-photos or upload endpoints).

요청 예시

바로 붙여 넣을 수 있는 본문입니다. 예시 ID와 값을 실제 값으로 바꾸세요.

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "photoIds": [      "TWVkaWFGaWxlOjU4Nzg5MzI="    ]  }}

응답

200Photos removed. `removedCount` reports how many media files were detached.
Response
{  "data": {    "removeLocationPhotos": {      "clientMutationId": null,      "removedCount": 1,      "errors": null    }  }}
401Unauthenticated, missing or invalid API key.

사업장에서 미디어 연결을 해제합니다. photoIds(get-photos 또는 업로드 엔드포인트에서 반환된 ID)로 제거할 파일을 지정합니다. 응답의 removedCount는 실제로 연결이 해제된 파일 수를 알려 주므로, 이미 제거된 ID가 있는지 확인할 수 있습니다.

사용 사례: 오래된 매장 외관 이미지 제거. 리모델링 후 사업장의 사진 목록을 조회하고, 오래된 추가 이미지를 선택한 다음, 해당 ID를 photoIds에 전달하여 한 번의 호출로 여러 게시 플랫폼에서 해당 이미지를 내립니다.

사용 사례: 잘못된 일괄 업로드 취소. 자동 가져오기로 잘못된 자산이 연결된 경우, 업로드 응답에서 문제가 있는 미디어 ID를 수집하여 즉시 제거한 다음 올바른 파일을 다시 업로드합니다.

주의 사항.

  • API를 통해 제거할 수 있는 사진은 ADDITIONAL 카테고리의 사진뿐입니다. LOGO 및 COVER 이미지는 여기에서 삭제할 수 없으므로, 대신 업로드 엔드포인트를 통해 교체합니다.
  • 미디어를 제거하면 사업장과의 연결이 해제되며, 계정 미디어 라이브러리에서 파일이 반드시 완전히 삭제되는 것은 아닙니다.
  • removedCount가 0이고 errors: null인 경우, 제공된 ID 중 해당 사업장에 연결된 ID가 하나도 없었음을 의미합니다.
Request
curl -X POST 'https://listingsapi.com/api/v4/locations/photos/remove' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "photoIds": [        "TWVkaWFGaWxlOjU4Nzg5MzI="      ]    }  }'
Run in playground