Listagens

Gerencie listagens premium, de voz e duplicadas em diretórios por meio de client.listings.

Todos os métodos de listagens estão em client.listings. Os métodos que recebem um location_id aceitam IDs numéricos ou codificados em base64; consulte IDs de locais.

`listings.premium`

Obtenha listagens em diretórios premium (Google, Yelp, Facebook etc.) para um local.

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}")

Valores comuns de syncStatus: SYNCED, PENDING, NOT_SYNCED, ERROR.

`listings.voice`

Obtenha listagens em assistentes de voz (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`

Obtenha listagens duplicadas de um único local.

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`

Obtenha listagens duplicadas de todos os locais, com filtro opcional por tag.

Python

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

Parâmetro	Tipo	Descrição
`tag`	`str`	Restrinja a consolidação a uma tag. Omita para incluir todos os locais aos quais a chave tem acesso.
`page`	`int`	Número da página, começando em 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)

Nenhum dos argumentos é obrigatório. Quando você os omite, os valores padrão são status: POTENTIAL e tag: all, então a chamada sem argumentos retorna as possíveis duplicatas em aberto da conta. O payload é uma página baseada em deslocamento: records[] mais pageInfo com totalRecords / totalPages.

`listings.mark_duplicate`

Marque itens de listagem como duplicados para um local.

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`

Remova o status de duplicado dos itens de listagem.

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`

Vincule um local a uma listagem de uma conta conectada.

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`

Desconecte um local da sua listagem no Google ou no Facebook.

Python

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

site não diferencia maiúsculas de minúsculas; o SDK converte esse valor para maiúsculas antes de enviá-lo.

Python

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

`listings.create_gmb`

Crie uma listagem no Google Business Profile para um local existente na Listings API.

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",)

Veja também

Locais: IDs e ciclo de vida dos locais
Casos de uso: roteiro de auditoria de listagens (caso de uso 6)