Schede

Gestisci le schede premium, vocali e duplicate nelle directory tramite client.listings.

Tutti i metodi per le schede si trovano in client.listings. I metodi che richiedono un location_id accettano ID numerici o codificati in base64; vedi ID delle sedi.

`listings.premium`

Recupera le schede nelle directory premium (Google, Yelp, Facebook, ecc.) per una sede.

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

Valori comuni di syncStatus: SYNCED, PENDING, NOT_SYNCED, ERROR.

`listings.voice`

Recupera le schede per gli assistenti vocali (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`

Recupera le schede duplicate per una singola sede.

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`

Recupera le schede duplicate di tutte le sedi, con un filtro facoltativo per tag.

Python

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

Parametro	Tipo	Descrizione
`tag`	`str`	Limita l'aggregazione a un solo tag. Omettilo per includere tutte le sedi a cui la chiave ha accesso.
`page`	`int`	Numero di pagina, a partire da 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)

Nessuno dei due argomenti è obbligatorio. Se li ometti, i valori predefiniti sono status: POTENTIAL e tag: all, quindi la chiamata senza argomenti restituisce i potenziali duplicati aperti dell'account. Il payload è una pagina basata su offset: records[] più pageInfo con totalRecords / totalPages.

`listings.mark_duplicate`

Contrassegna come duplicati gli elementi delle schede di una sede.

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`

Rimuovi lo stato di duplicato dagli elementi delle schede.

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`

Collega una sede a una scheda di un account connesso.

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`

Scollega una sede dalla sua scheda Google o Facebook.

Python

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

site non distingue tra maiuscole e minuscole; l'SDK lo converte in maiuscolo prima dell'invio.

Python

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

`listings.create_gmb`

Crea una scheda Google Business Profile per una sede già esistente in 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",)

Vedi anche

Sedi: ID e ciclo di vita delle sedi
Casi d'uso: procedura di verifica delle schede (caso d'uso 6)