Fichas

Gestiona las fichas prémium, de voz y duplicadas en directorios mediante client.listings.

Todos los métodos de fichas están en client.listings. Los métodos que reciben un location_id aceptan IDs numéricos o codificados en base64; consulta IDs de ubicación.

`listings.premium`

Obtén las fichas de una ubicación en directorios prémium (Google, Yelp, Facebook, etc.).

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 habituales de syncStatus: SYNCED, PENDING, NOT_SYNCED, ERROR.

`listings.voice`

Obtén las fichas de asistentes 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`

Obtén las fichas duplicadas de una sola ubicación.

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`

Obtén las fichas duplicadas de todas las ubicaciones, con un filtro opcional por etiqueta.

Python

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

Parámetro	Tipo	Descripción
`tag`	`str`	Limita el resumen agregado a una etiqueta. Omítelo para incluir todas las ubicaciones a las que la clave tiene acceso.
`page`	`int`	Número de página, empezando por 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)

Ninguno de los dos argumentos es obligatorio. Si los omites, los valores predeterminados son status: POTENTIAL y tag: all, por lo que la llamada sin argumentos devuelve los posibles duplicados pendientes de la cuenta. El contenido de la respuesta es una página con paginación por desplazamiento: records[] más pageInfo con totalRecords / totalPages.

`listings.mark_duplicate`

Marca elementos de fichas como duplicados para una ubicación.

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`

Elimina el estado de duplicado de los elementos de fichas.

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`

Vincula una ubicación a una ficha de una cuenta 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`

Desconecta una ubicación de su ficha de Google o Facebook.

Python

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

site no distingue entre mayúsculas y minúsculas; el SDK lo convierte a mayúsculas antes de enviarlo.

Python

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

`listings.create_gmb`

Crea una ficha de Google Business Profile para una ubicación existente en 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",)

Consulta también

Ubicaciones: IDs de ubicación y ciclo de vida
Casos de uso: procedimiento de auditoría de fichas (caso de uso 6)