추출 결과로 컬렉션에 장소 추가

Tested

POST

/collections/{collectionId}/extraction-jobs/{jobId}/places

[설명]

최소 1개 이상의 장소를 저장할 때 호출할 수 있습니다.

성공했으나 장소를 저장하지 않아도 되는 작업이라면 추출 작업 무시 API를 호출할 수 있습니다.

decision_status를 UNDECIDED → SELECTED로 변경합니다.

이미 컬렉션에 저장된 장소는 제외하고 컬렉션 장소로 저장됩니다.

[제약 조건]

place_ids 1개 이상

[에러]

COLLECTION_NOT_FOUND(404)

JOB_NOT_FOUND(404)

ALREADY_DECIDED(409)

MEMBER_NOT_FOUND(404)

FORBIDDEN_NOT_MEMBER(403)

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/collections//extraction-jobs//places' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "place_ids": [
        "string"
    ]
}'

Response Example

{
    "total_count": 0,
    "added_count": 0,
    "skipped_count": 0,
    "places": [
        {
            "collection_place_id": "string",
            "memo": "string",
            "place": {
                "place_id": "53",
                "google_place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
                "name": "카페 오르빗",
                "address": "서울특별시 마포구 연남동 123-45",
                "category": {
                    "level1": {
                        "category_id": "",
                        "name": "F&B"
                    },
                    "level2": {
                        "category_id": "",
                        "name": "식당"
                    },
                    "level3": {
                        "category_id": "",
                        "name": "한식"
                    },
                    "primary_type": {
                        "category_id": "",
                        "name": "korean_restaurant"
                    }
                },
                "google_maps_uri": "https://maps.google.com/?cid=1234567890123456789",
                "photos": [
                    "https://lh3.googleusercontent.com/p/AF1QipNabc123",
                    "https://lh3.googleusercontent.com/p/AF1QipNdef456"
                ],
                "point": {
                    "latitude": "37.566535",
                    "longitude": "126.977969"
                }
            },
            "pick_pass": {
                "picked": {
                    "members": [
                        {
                            "collection_member_id": "string",
                            "nickname": "string",
                            "picture": "string",
                            "role": "OWNER"
                        }
                    ],
                    "count": 0
                },
                "passed": {
                    "members": [
                        {
                            "collection_member_id": "string",
                            "nickname": "string",
                            "picture": "string",
                            "role": "OWNER"
                        }
                    ],
                    "count": 0
                },
                "my_preference": "PICK "
            }
        }
    ]
}

Modified at 2026-03-02 17:18:28

추출 작업 무시(삭제)

검색 결과에서 컬렉션에 장소 추가