등록 정보

client.listings을 통해 프리미엄, 음성 및 중복 디렉터리 등록 정보를 관리합니다.

모든 등록 정보 메서드는 client.listings에 있습니다. location_id을 받는 메서드는 숫자 또는 base64로 인코딩된 ID를 허용하며, 자세한 내용은 사업장 ID를 참조하세요.

`listings.premium`

사업장의 프리미엄 디렉터리 등록 정보(Google, Yelp, Facebook 등)를 가져옵니다.

Python

client.listings.premium(location_id: str | int) -> list[APIObject]

Python

listings = client.listings.premium(16808)for listing in listings:  site = listing.get("site", "N/A")  status = listing.get("syncStatus", "N/A")  print(f"{site}: {status}")

일반적인 syncStatus 값: SYNCED, PENDING, NOT_SYNCED, ERROR.

`listings.voice`

음성 비서 등록 정보(Google Assistant, Alexa, Siri)를 가져옵니다.

Python

client.listings.voice(location_id: str | int) -> list[APIObject]

Python

voice = client.listings.voice(16808)print(f"{len(voice)} voice assistant listings")

`listings.duplicates`

단일 사업장의 중복 등록 정보를 가져옵니다.

Python

client.listings.duplicates(location_id: str | int) -> list[APIObject]

Python

dupes = client.listings.duplicates(16808)print(f"Found {len(dupes)} duplicate listings")

`listings.all_duplicates`

모든 사업장의 중복 등록 정보를 가져오며, 선택적으로 태그 필터를 적용할 수 있습니다.

Python

client.listings.all_duplicates(    *,    tag: str | None = None,    page: int | None = None,) -> APIObject

매개변수	유형	설명
`tag`	`str`	집계 범위를 하나의 태그로 제한합니다. 생략하면 키로 조회할 수 있는 모든 사업장이 포함됩니다.
`page`	`int`	1부터 시작하는 페이지 번호입니다.

Python

rollup = client.listings.all_duplicates(page=1)print(rollup.to_dict()) # Scope to one tagrollup = client.listings.all_duplicates(tag="northeast", page=1)

두 인수 모두 필수가 아닙니다. 두 인수를 생략하면 기본값인 status: POTENTIAL과 tag: all이 적용되므로, 인수 없이 호출하면 계정의 미해결 잠재적 중복 항목이 반환됩니다. 페이로드는 오프셋 기반 페이지로, records[]와 totalRecords / totalPages이 포함된 pageInfo으로 구성됩니다.

`listings.mark_duplicate`

사업장의 등록 정보 항목을 중복으로 표시합니다.

Python

client.listings.mark_duplicate(    location_id: str | int,    listing_item_ids: list[str],) -> APIObject

Python

result = client.listings.mark_duplicate(  location_id=16808,  listing_item_ids=["item-uuid-1", "item-uuid-2"],)print(result.to_dict())

`listings.mark_not_duplicate`

등록 정보 항목의 중복 상태를 해제합니다.

Python

client.listings.mark_not_duplicate(    location_id: str | int,    listing_item_ids: list[str],) -> APIObject

Python

client.listings.mark_not_duplicate(16808, ["item-uuid-1"])

`listings.connect`

사업장을 연결된 계정의 등록 정보에 연결합니다.

Python

client.listings.connect(    location_id: str | int,    connected_account_listing_id: str,    connected_account_id: str,) -> APIObject

Python

result = client.listings.connect(  location_id=16808,  connected_account_listing_id="ca-listing-uuid",  connected_account_id="ca-uuid",)

`listings.disconnect`

사업장과 해당 Google 또는 Facebook 등록 정보의 연결을 해제합니다.

Python

client.listings.disconnect(    location_id: str | int,    site: str,) -> APIObject

site은 대소문자를 구분하지 않으며, SDK는 전송 전에 이를 대문자로 변환합니다.

Python

client.listings.disconnect(16808, site="google")client.listings.disconnect(16808, site="facebook")

`listings.create_gmb`

기존 Listings API 사업장에 대한 Google Business Profile 등록 정보를 생성합니다.

Python

client.listings.create_gmb(    location_id: str | int,    connected_account_id: str,    *,    folder_id: str | None = None,) -> APIObject

Python

result = client.listings.create_gmb(  location_id=16808,  connected_account_id="ca-uuid",)