Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Visualizzazione inventario

Panoramica

Inventory Viewer in Actions Center offre visibilità sullo stato di importazione, sullo stato di corrispondenza dei luoghi e sull'idoneità alla pubblicazione dell'inventario locale dei punti di interesse (PDI).

Questo visualizzatore mostra i problemi indipendentemente dalle singole importazioni, ovvero i problemi stateful che rappresentano lo stato di pubblicazione attivo di ogni fornitore di servizi, incorporando tutte le possibili modalità di errore (norme, avvisi, errori e così via) che potrebbero verificarsi.

Utilizza questo strumento per:

Cerca e ispeziona tutti i fornitori di servizi importati e i relativi stati di pubblicazione in tempo reale.
Diagnostica gli errori di convalida dei dati e le violazioni delle norme relative ai contenuti.
Presentare e monitorare i ricorsi per eventuali violazioni delle norme.
Esaminare la diagnostica di corrispondenza del fornitore di servizi e inviare proposte di corrispondenza manuale.
Esamina i payload JSON non elaborati delle ultime importazioni dei feed.

Colonne della tabella di inventario

La visualizzazione elenco mostra tutti i fornitori di servizi caricati dal feed dei punti di interesse (PDI), organizzati gerarchicamente per entità. Puoi filtrare in base all'ID del PDI locale, allo stato di corrispondenza, all'integrazione e alla piattaforma.

Colonne della tabella di riepilogo	Descrizione
ID PDI locale	L'identificatore univoco della proprietà locale fornito nel feed (`poi_id`).
Nome del PDI locale	Il nome localizzato della proprietà locale estratto dal feed.
Stato della corrispondenza	Indica se il PDI è stato abbinato a una scheda di Google Maps: • Sì (badge verde): abbinato correttamente a un luogo di Google Maps. • No (badge rosso): nessuna corrispondenza; richiede una revisione o una proposta di corrispondenza.
Integrazione	Questa è l'integrazione dell'unità di aggregatori locali.
Superficie	La piattaforma di pubblicazione di destinazione (ad es. la Ricerca).
Stato di pubblicazione	Lo stato di idoneità alla pubblicazione in tempo reale: • Attivato (indicatore verde): idoneo e pubblicabile attivamente sulle piattaforme Google. • Disattivato (indicatore rosso): la pubblicazione è bloccata a causa di errori di convalida, violazioni delle norme o stato non corrispondente.
Errori	Numero di problemi attivi con gravità Errore. La presenza di un errore per una proprietà significa che questa non sarà idonea alla pubblicazione su nessuna piattaforma.
Avvisi	Numero di problemi attivi con gravità Avviso. Le proprietà con avvisi sono comunque idonee alla pubblicazione.
Informazioni sulla partita	Contiene il pulsante Modifica corrispondenza, che apre il riquadro interattivo per la correzione delle corrispondenze.

Visualizzazione dei dettagli dei PDI

Se fai clic su un ID POI nella visualizzazione elenco, viene visualizzata la pagina dei dettagli dedicata dell'entità.

La visualizzazione dei dettagli è composta da quattro sezioni espandibili:

1. Informazioni di base

Riassume i metadati delle entità di alto livello:

Nome del PDI: nome dell'attività analizzato da data[].name.localizations.
ID PDI: identificatore univoco dell'entità partner (poi_id).
Origine dati: il nome file esatto del feed da cui è stata importata questa entità.

2. Stato elaborazione

Suddivide l'idoneità alla pubblicazione per integrazione e piattaforma di destinazione:

Integrazione e piattaforma: verticale e piattaforma di destinazione (ad es. Local Aggregator Unit su Search).
Stato di pubblicazione: stato attuale di Enabled o Disabled.
Problemi: mostra i badge dei problemi per tutti gli errori o gli avvisi attivi (ad es. Unmatched entity, Policy Violation). Se fai clic su un badge di un problema, si apre il riquadro dei dettagli del problema.
Ricorsi: mostra gli stati di override o ricorso (Under review, Approved o Rejected).

3. Informazioni sulla corrispondenza

Mostra la diagnostica per la corrispondenza dei luoghi:

Input di corrispondenza: l'indirizzo fisico formattato analizzato dal feed (street_address, locality, region, postal_code, country).
Tipo di corrispondenza: il meccanismo di risoluzione della corrispondenza (ad es. Location).
Spazio dei nomi di corrispondenza: il verticale a cui verranno applicate le modifiche alla corrispondenza (ad es. Local Aggregator Unit).
Stato della corrispondenza: Yes (Verde) o No (Rosso).
Output di corrispondenza: il nome, l'indirizzo e l'ID luogo di Google Maps risolti.
Modifica corrispondenza: pulsante per aprire la finestra di dialogo della proposta di corrispondenza.

4. JSON non elaborato

Fornisce un visualizzatore di codice interattivo con numeri di riga ed evidenziazione della sintassi che mostra il payload JSON analizzato completo (item_proto) per il debug e la verifica rapidi dello schema. I valori dei dati presentati qui rifletteranno i valori ricevuti dal feed dei PDI.

Workflow per problemi e valutazione

Le entità contrassegnate con problemi sono disattivate (se contrassegnate con un ERRORE) o degradate (se contrassegnate con un AVVISO). I problemi delle entità con un avviso non sono appellabili e gli avvisi possono essere risolti correggendo il problema sottostante.

Tipi di problemi: con possibilità di ricorso e senza possibilità di ricorso

Problemi non appellabili (convalide tecniche, di qualità dei dati e di avviso):
- Causati da errori dello schema, campi obbligatori mancanti, coordinate non valide, URL non funzionanti, ID duplicati o avvisi relativi ai contenuti non bloccanti (ad esempio nomi di attività con impostazioni internazionali non predefinite o impostazioni internazionali per descrizioni, indirizzi visualizzati e categorie di attività).
- Risoluzione: i partner devono correggere i dati sottostanti nel feed di origine e caricare un file del feed aggiornato.
Problemi per cui è possibile presentare ricorso (contenuti bloccati e violazioni delle norme):
- Attivato quando gli asset di testo o asset immagine della proprietà obbligatori non superano i filtri automatici di sicurezza dei contenuti con un livello di gravità ERRORE.
- Risoluzione: se i contenuti sono conformi alle norme della piattaforma, i partner possono fare clic sul pulsante Presenta ricorso accanto al problema nel Centro azioni per presentare un ricorso. I partner devono fornire una motivazione e una giustificazione e il nostro team per i ricorsi esaminerà e approverà o rifiuterà le richieste. Riceverai una notifica tramite lo strumento e via email in merito alle decisioni prese.

Catalogo dei problemi delle unità di aggregatori locali

La tabella seguente illustra l'insieme completo di errori di convalida e codici dei problemi relativi alle norme per le integrazioni di unità di aggregazione locale:

Descrizione del problema	Gravità	Codice problema	Campo / argomenti interessati	È possibile fare ricorso?	Azione / Norma pertinente
ID del PDI mancante	ERROR	`MISSING_REQUIRED_FIELD`	`poi_id`	No	Fornisci un `poi_id` univoco. Consulta la specifica del feed dei PDI.
Impostazioni internazionali predefinite mancanti per il campo "name"	ERROR	`MISSING_REQUIRED_FIELD`	`name.default_locale`	No	Specifica un codice lingua BCP 47 valido per le impostazioni internazionali predefinite. Consulta Assistenza multilingue.
Nessuna localizzazione predefinita trovata per il campo "name"	ERROR	`MISSING_REQUIRED_FIELD`	`name.localizations`	No	Fornisci un valore per il nome localizzato del PDI corrispondente alla lingua `default_locale` dichiarata.
Impostazioni internazionali predefinite mancanti per il campo "description"	ERROR	`MISSING_REQUIRED_FIELD`	`description.default_locale`	No	Specifica un'impostazione internazionale predefinita BCP 47 valida per la descrizione della proprietà.
Nessuna localizzazione predefinita trovata per il campo "description"	ERROR	`MISSING_REQUIRED_FIELD`	`description.localizations`	No	Fornisci un testo descrittivo corrispondente alla lingua `default_locale` dichiarata.
Impostazioni internazionali predefinite mancanti per il campo "display_address"	ERROR	`MISSING_REQUIRED_FIELD`	`display_address.default_locale`	No	Specifica un'impostazione internazionale predefinita BCP 47 valida per l'indirizzo di visualizzazione.
Nessuna localizzazione predefinita trovata per il campo "display_address"	ERROR	`MISSING_REQUIRED_FIELD`	`display_address.localizations`	No	Fornisci il testo dell'indirizzo formattato corrispondente alla lingua `default_locale` dichiarata.
Numero massimo di immagini superato	AVVISO	`EXCEEDED_MAX_COUNT`	`images`	No	Limita le voci di immagini a un massimo di 5 immagini per PDI. Le immagini in eccesso vengono ignorate.
Coordinata di latitudine non valida	ERROR	`INVALID_LATLNG`	`location.latitude`	No	Inserisci una latitudine valida compresa tra `-90.0` e `+90.0`. Consulta la definizione delle coordinate geografiche.
Coordinata di longitudine non valida	ERROR	`INVALID_LATLNG`	`location.longitude`	No	Inserisci una longitudine valida compresa tra `-180.0` e `+180.0`. Consulta la definizione delle coordinate geografiche.
Coordinata di latitudine mancante	ERROR	`MISSING_REQUIRED_FIELD`	`location.latitude`	No	Fornisci il valore della latitudine per completare la coppia di coordinate. Consulta la definizione delle coordinate geografiche.
Coordinata di longitudine mancante	ERROR	`MISSING_REQUIRED_FIELD`	`location.longitude`	No	Fornisci il valore di longitudine per completare la coppia di coordinate. Consulta la definizione delle coordinate geografiche.
Indirizzo mancante o non strutturato	ERROR	`MISSING_REQUIRED_FIELD`	`location.address`	No	Fornisci un indirizzo postale strutturato che includa via, località, codice postale e paese.
URL non valido o con formato non corretto	ERROR	`INVALID_ATTRIBUTE_VALUE`	`url`	No	Assicurati che l'URL pagina di destinazione utilizzi un protocollo HTTP/HTTPS supportato e una sintassi valida.
Immagine non valida o non raggiungibile	AVVISO	`INVALID_IMAGE`	`image.url`	No	Verifica che gli URL delle immagini siano raggiungibili pubblicamente e non richiedano l'autenticazione o non restituiscano errori 4xx/5xx.
ID PDI duplicato	ERROR	`DUPLICATE_ENTITY`	`poi_id`	No	Assicurati che ogni `poi_id` sia univoco nel payload del feed. Rimuovi le voci duplicate.
Entità corrispondente duplicata	ERROR	`DUPLICATE_MATCHED_ENTITY`	`POI`	No	Rimuovi le voci duplicate dal feed o utilizza lo strumento POI Entity Matching per abbinare attività distinte alle relative schede di Google Maps indipendenti.
Entità non corrispondente	ERROR	`UNMATCHED_ENTITY`	`POI`	No	Abbina il PDI a una scheda di un luogo di Google Maps utilizzando lo strumento Corrispondenza entità PDI.
Violazione delle norme relative alle immagini	ERROR	`SAFE_SEARCH_POLICY_VIOLATION_IMAGE`	`image`	Sì	Rimuovi o sostituisci l'immagine segnalata oppure fai clic su Ricorso per inviare una giustificazione. Consulta le norme relative alle immagini dei contenuti della Ricerca Google.
Violazione delle norme relative al testo - Nome predefinito	ERROR	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`name.localizations.*.text`	Sì	Rimuovi o sostituisci il testo del nome segnalato oppure fai clic su Presenta ricorso. Consulta le norme relative ai contenuti testuali della Ricerca Google.
Violazione delle norme relative al testo - Nome non predefinito	AVVISO	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`name.localizations.*.text`	No	Rimuovi o sostituisci il testo del nome segnalato. Consulta le norme relative ai contenuti testuali della Ricerca Google.
Violazione delle norme relative al testo - Descrizione	AVVISO	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`description.localizations.*.text`	No	Rimuovi o sostituisci il testo della descrizione segnalato. Consulta le norme relative ai contenuti testuali della Ricerca Google.
Violazione delle norme relative al testo - Indirizzo di visualizzazione	AVVISO	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`display_address.localizations.*.text`	No	Rimuovi o sostituisci il testo dell'indirizzo visualizzato segnalato. Consulta le norme relative ai contenuti testuali della Ricerca Google.
Impostazioni internazionali predefinite mancanti per la categoria dell'attività	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.establishment_category.default_locale`	No	Fornisci un valore per la categoria dell'attività localizzata del PDI corrispondente alla lingua `default_locale` dichiarata.
Giorno di apertura dell'orario di apertura mancante	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.open_day`	No	Fornisci un giorno di apertura valido per l'orario di apertura.
Ora di apertura dell'orario di apertura mancante	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.open_time`	No	Fornisci un orario di apertura valido.
Mancano l'orario di apertura e il giorno di chiusura	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.close_day`	No	Fornisci un giorno di chiusura valido per l'orario di apertura.
Ora di chiusura dell'orario di apertura mancante	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.business_hours.time_ranges.close_time`	No	Fornisci un orario di chiusura valido per l'orario di apertura.
L'orario di apertura è successivo all'orario di chiusura	ERROR	`NOT_LESS_THAN_FIELD`	`local_data.business_hours.time_ranges.open_time`, `local_data.business_hours.time_ranges.close_time`	No	Fornisci una coppia valida di orari di apertura e chiusura, assicurandoti che l'orario di apertura sia precedente a quello di chiusura.
Il valore minimo della fascia di prezzo è maggiore del valore massimo	ERROR	`INVALID_PRICE_RANGE`	`local_data.price_range.min_price`, `local_data.price_range.max_price`	No	Fornisci una fascia di prezzo valida, con il prezzo minimo inferiore al prezzo massimo.
ID brand mancante	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.brand_id`	No	Fornisci un ID brand valido.
ID brand duplicato all'interno di un PDI	ERROR	`DUPLICATE_UNIQUE_PROPERTY`	`local_data.brand_landing_pages.brand_id`	No	Assicurati che ogni `brand_id` sia univoco nel payload del PDI. Rimuovi le voci duplicate.
URL predefinito del brand mancante	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.default_url`	No	Fornisci un URL predefinito del brand valido.
URL del brand non valido o con formato errato	ERROR	`INVALID_ATTRIBUTE_VALUE`	`local_data.brand_landing_pages.default_url`	No	Assicurati che l'URL predefinito del brand utilizzi un protocollo HTTP/HTTPS supportato e una sintassi valida.
URL pagina di destinazione localizzata del brand mancante	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.localized_landing_pages.url`	No	Fornisci un URL valido per la pagina di destinazione localizzata.
URL pagina di destinazione localizzata del brand non valido o con formato non corretto	ERROR	`INVALID_ATTRIBUTE_VALUE`	`local_data.brand_landing_pages.localized_landing_pages.url`	No	Assicurati che l'URL pagina di destinazione localizzato utilizzi un protocollo HTTP/HTTPS supportato e una sintassi valida.
URL pagina di destinazione localizzata del brand duplicato	ERROR	`DUPLICATE_UNIQUE_PROPERTY`	`local_data.brand_landing_pages.localized_landing_pages.url`	No	Assicurati che ogni `url` sia univoco nelle pagine di destinazione localizzate dei PDI. Rimuovi le voci duplicate.
Pagina di destinazione localizzata del brand mancante	ERROR	`MISSING_REQUIRED_FIELD`	`local_data.brand_landing_pages.localized_landing_pages.locales`	No	Fornisci un insieme di impostazioni internazionali valido per la pagina di destinazione localizzata.
Pagina di destinazione localizzata del brand duplicata	ERROR	`DUPLICATE_UNIQUE_PROPERTY`	`local_data.brand_landing_pages.localized_landing_pages.locales`	No	Assicurati che ogni `locale` sia univoco nelle pagine di destinazione localizzate dei PDI. Rimuovi le voci duplicate.
Violazione delle norme relative al testo - Categoria dell'attività	AVVISO	`SAFE_SEARCH_POLICY_VIOLATION_TEXT`	`local_data.establishment_category.localizations.*.text`	No	Rimuovi o sostituisci il testo della categoria dell'attività segnalata. Consulta le norme relative ai contenuti testuali della Ricerca Google.

Codici dei problemi

Le sezioni seguenti forniscono cause dettagliate e passaggi di correzione per ogni codice problema.

Campo obbligatorio mancante

Codice problema: MISSING_REQUIRED_FIELD
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (risolvi aggiornando il feed dei PDI)

Questo errore si verifica quando un'entità importata non contiene uno o più attributi obbligatori richiesti dalla specifica del feed dei punti d'interesse.

Controlla il riquadro Dettagli problema per identificare la proprietà specifica mancante, quindi applica la correzione corrispondente:

1. ID PDI mancante (`poi_id`)

Causa: il campo poi_id è vuoto, nullo o mancante nell'oggetto entità base.
Correzione: fornisci un identificatore di stringa univoco e permanente per la proprietà.

{
  "poi_id": "test_restaurant_1"
}

2. Impostazioni internazionali predefinite o nome localizzato mancanti (`name`)

Causa: nell'oggetto name manca la stringa default_locale o l'array localizations con un'impostazione internazionale corrispondente.
Correzione: fornisci sia default_locale sia almeno una voce di localizzazione corrispondente alle impostazioni internazionali.

{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. Impostazioni internazionali predefinite o indirizzo localizzato mancanti (`display_address`)

Causa: nell'oggetto display_address manca la stringa default_locale o l'array localizations.
Correzione: fornisci sia default_locale sia almeno una voce di localizzazione corrispondente a quella lingua per l'indirizzo formattato.

{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. Impostazioni internazionali predefinite o descrizione localizzata mancanti (`description`)

Causa: quando l'oggetto description è incluso, manca default_locale o la localizzazione corrispondente.
Correzione: fornisci sia default_locale sia almeno una voce di localizzazione corrispondente alle impostazioni internazionali per la descrizione.

{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. Coordinate geografiche mancanti (`location.latitude` / `location.longitude`)

Causa: nell'oggetto location manca il valore numerico latitude o longitude.
Correzione: fornisci sia latitude che longitude come numeri in virgola mobile in gradi decimali WGS84 standard.

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. Indirizzo postale strutturato mancante (`location.address`)

Causa: nell'oggetto location.address mancano componenti obbligatori dell'indirizzo (country, locality o postal_code).
Correzione: compila l'oggetto dell'indirizzo postale strutturato in base agli standard ISO.

{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. Impostazioni internazionali predefinite mancanti per la categoria dell'attività (`local_data.establishment_category.default_locale`)

Causa: l'oggetto local_data.establishment_category è presente, ma default_locale è mancante, vuoto o non corrisponde ad alcuna voce nell'array localizations.
Correzione: specifica un tag lingua BCP 47 valido per default_locale e fornisci almeno una stringa localizzata corrispondente alle impostazioni internazionali.

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. Giorno di apertura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.open_day`)

Causa: manca una voce in local_data.business_hours.time_ranges open_day o è impostata su DAY_OF_WEEK_UNSPECIFIED.
Correzione: fornisci una stringa del giorno della settimana valida (ad es. "MONDAY", "TUESDAY" e così via).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

9. Ora di apertura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.open_time`)

Causa: in una voce di local_data.business_hours.time_ranges manca l'oggetto open_time.
Correzione: specifica open_time con hours (0-23) e minutes (0-59).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

10. Giorno di chiusura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.close_day`)

Causa: manca una voce in local_data.business_hours.time_ranges close_day o è impostata su DAY_OF_WEEK_UNSPECIFIED.
Correzione: fornisci una stringa del giorno della settimana valida (ad es. "MONDAY", "TUESDAY" e così via).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

11. Ora di chiusura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.close_time`)

Causa: in una voce di local_data.business_hours.time_ranges manca l'oggetto close_time.
Correzione: specifica close_time con hours (0-23) e minutes (0-59).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

12. ID brand mancante (`local_data.brand_landing_pages.brand_id`)

Causa: una voce in local_data.brand_landing_pages ha un valore brand_id vuoto, nullo o mancante.
Correzione: fornisci un identificatore di stringa non vuoto corrispondente alla configurazione del brand partner registrato.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. URL predefinito del brand mancante (`local_data.brand_landing_pages.default_url`)

Causa: manca una voce in local_data.brand_landing_pages default_url o è una stringa vuota.
Correzione:fornisci un URL pagina di destinazione HTTP/HTTPS di riserva valido per gli utenti le cui impostazioni internazionali non corrispondono agli URL localizzati.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. URL pagina di destinazione localizzata del brand mancante (`local_data.brand_landing_pages.localized_landing_pages.url`)

Causa: un elemento all'interno di localized_landing_pages ha un campo url mancante o vuoto.
Correzione: fornisci un URL HTTP/HTTPS valido e completo per la pagina di destinazione localizzata.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

15. Impostazioni internazionali della pagina di destinazione localizzata del brand mancanti (`local_data.brand_landing_pages.localized_landing_pages.locales`)

Causa: un elemento all'interno di localized_landing_pages ha un array locales mancante o vuoto.
Correzione: fornisci almeno un codice lingua o un codice delle impostazioni internazionali BCP 47 valido (ad es. ["en-US"]) nell'array locales.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

Numero massimo di immagini superato

Codice problema: EXCEEDED_MAX_COUNT
Gravità: Avviso
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo errore si verifica quando un payload dell'entità del PDI contiene più di 5 oggetti immagine nell'array images.

Correzione:

Taglia l'array images in modo che contenga al massimo 5 foto rappresentative di alta qualità della proprietà locale.
Le immagini che superano il limite di 5 verranno eliminate.

Coordinate geografiche non valide

Codice problema: INVALID_LATLNG
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo errore si verifica quando le coordinate geografiche fornite in location.latitude o location.longitude non rientrano nei limiti sferici validi o rappresentano coordinate nulle non popolate.

Cause comuni e correzione:

Latitudine fuori intervallo: la latitudine deve essere un numero in rappresentazione in virgola mobile compreso tra -90.0 e 90.0 inclusi.
Longitudine fuori intervallo: la longitudine deve essere un numero in rappresentazione in virgola mobile compreso tra -180.0 e 180.0 inclusi.
Null Island (0,0): l'invio di 0.0, 0.0 o di numeri interi segnaposto (come 999, 999) attiva il rifiuto delle coordinate.
Coordinate invertite:verifica che la latitudine e la longitudine non siano invertite nella pipeline di serializzazione.

Esempio di payload valido:

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

URL non valido o con formato non corretto

Codice problema: INVALID_ATTRIBUTE_VALUE
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo errore si verifica quando un valore dell'attributo non supera la convalida dello schema, il più delle volte quando l'URL della pagina di destinazione o l'URL dell'immagine del partner non è valido dal punto di vista sintattico.

Requisiti:

Protocollo:gli URL devono specificare esplicitamente http:// o https:// (HTTPS è vivamente consigliato).
Codifica: gli URL contenenti caratteri speciali, spazi o caratteri non ASCII devono essere codificati correttamente con il segno di percentuale (RFC 3986).
Dominio canonico:assicurati che il dominio sia completo (ad esempio, https://example.com/local/123, non example.com/local/123 o www.example).

Esempio di payload valido:

{
  "url": "https://www.tastybitestest.com/en"
}

Immagine non valida o non raggiungibile

Codice problema: INVALID_IMAGE
Gravità: Avviso
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo avviso viene visualizzato durante la fase di recupero asincrono delle immagini, quando il crawler di Google non riesce a scaricare, decodificare o verificare l'asset multimediale da image.url. Anche se l'immagine non valida viene omessa, la proprietà rimane idonea alla pubblicazione.

Cause comuni e correzione:

Errori HTTP (404 / 403 / 500): l'URL dell'immagine restituisce un codice di stato HTTP diverso da 200. Assicurati che le immagini siano accessibili pubblicamente senza autenticazione, cookie wall o limitazioni di liste consentite di IP.
Blocco di robots.txt:assicurati che la tua rete CDN (Content Delivery Network) consenta gli user agent Googlebot e Googlebot-Image.
Formato file non supportato: le immagini devono essere in formati raster standard (JPEG, PNG, WebP). Le GIF animate, gli SVG e i formati RAW della fotocamera non sono supportati. Per maggiori dettagli, consulta le nostre linee guida per le immagini.
Errori del certificato SSL: verifica che il server host delle immagini abbia una catena di certificati SSL valida.

ID PDI duplicato

Codice problema: DUPLICATE_ENTITY
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo errore si verifica quando la stessa stringa poi_id viene visualizzata più di una volta all'interno di un singolo set di file del feed.

Correzione:

Assicurati che ogni scheda locale nel feed abbia un poi_id univoco e deterministico.
Se una proprietà locale ha più tipi di camere o tariffe, consolidali in un'unica entità POI principale anziché emettere record di entità duplicati con ID identici.

Entità corrispondente duplicata

Codice problema: DUPLICATE_MATCHED_ENTITY
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (risolvi il problema aggiornando il payload del feed o utilizzando gli strumenti di corrispondenza delle entità dei PDI)

Questo errore si verifica quando due o più voci poi_id distinte nel tuo feed corrispondono alla stessa scheda di un luogo su Google Maps. Quando più attività corrispondono alla stessa entità Google, la pubblicazione di tutte le voci in conflitto viene bloccata fino alla risoluzione della duplicazione.

Come risolvere il problema:

Identifica le proprietà in conflitto:apri il Visualizzatore di importazione (Importazione > Cronologia), seleziona l'ultima esecuzione dell'importazione ed espandi il riquadro Convalide. Fai clic sulla riga DUPLICATE_MATCHED_ENTITY che condivide lo stesso identificatore del gruppo Informazioni sul problema per visualizzare tutti i record poi_id che corrispondono alla stessa entità Google.
Rimuovi le schede duplicate dal feed: se le voci poi_id in conflitto rappresentano la stessa sede fisica dell'attività, rimuovi le voci duplicate dal feed in modo che venga inviato un solo poi_id per l'attività.
Correggi le corrispondenze errate per le attività indipendenti:se le voci poi_id in conflitto rappresentano attività separate e indipendenti che sono state erroneamente abbinate alla stessa entità Google, apri l'attività abbinata in modo errato nella visualizzazione Inventario e fai clic su Modifica corrispondenza per selezionare o proporre la scheda del luogo di Google Maps dedicata. Istruzioni dettagliate sono disponibili nella guida alla corrispondenza delle entità dei PDI.

Entità senza corrispondenza

Codice problema: UNMATCHED_ENTITY
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (utilizza gli strumenti di corrispondenza delle entità dei PDI o correggi i metadati delle entità)

Questo problema indica che la pipeline di corrispondenza di Google non è riuscita a riconciliare la tua scheda locale con un luogo canonico in Google Maps.

Come risolvere il problema:

Verifica gli attributi principali:assicurati che name, display_address, location.address, url, telephone e location.latitude/location.longitude della proprietà riflettano con precisione la posizione della proprietà fisica.
Esamina le informazioni sulla corrispondenza:guarda la colonna Informazioni sulla corrispondenza nella visualizzazione Inventario per vedere i luoghi candidati.
Utilizza lo strumento di correzione della corrispondenza dei PDI:fai clic su Modifica corrispondenza in Action Center per cercare e confermare manualmente l'ID luogo Google corretto. Istruzioni dettagliate sono disponibili nella guida Corrispondenza delle entità dei PDI.

Violazione delle norme relative alle immagini della Ricerca Google

Codice problema: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Gravità: ERRORE (blocca la pubblicazione)
Ricorribile: Sì

Consulta i codici dei problemi relativi alle norme pertinenti qui: Norme relative alle immagini dei contenuti della Ricerca Google

Se ritieni che l'immagine sia stata segnalata per errore (falso positivo), fai clic su Crea ricorso nel riquadro Dettagli problema.

Violazione delle norme relative ai contenuti testuali della Ricerca Google - Nome

Codice problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravità: la gravità varia in base al campo (vedi i dettagli di seguito)
Campo interessato: name.localizations.*.text
Ricorribile: Sì (solo ERRORE per le impostazioni internazionali predefinite); No (Avviso per le impostazioni internazionali non predefinite)

Impostazioni internazionali predefinite (name.default_locale): ERRORE (Blocca la pubblicazione). La pubblicazione dell'intero PDI è bloccata. Se ritieni che il testo del nome delle impostazioni internazionali predefinite sia stato segnalato per errore (falso positivo), fai clic su Crea ricorso nel riquadro Dettagli del problema.
Impostazioni internazionali non predefinite: Avviso (non blocca la pubblicazione). Viene omessa solo la localizzazione segnalata, mentre il PDI rimane idoneo alla pubblicazione. Gli avvisi relativi alle impostazioni internazionali non predefinite non sono appellabili e possono essere risolti aggiornando il payload del feed.

Consulta i codici dei problemi relativi alle norme pertinenti qui: norme relative ai contenuti di testo della Ricerca Google

Violazione delle norme relative ai contenuti testuali della Ricerca Google - Descrizione

Codice problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravità: Avviso (non blocca la pubblicazione)
Campo interessato: description.localizations.*.text
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo avviso viene visualizzato quando il testo di description.localizations viene segnalato per violazione delle norme relative ai contenuti testuali della Ricerca Google. Anche se la localizzazione della descrizione segnalata (o l'intero campo description se viene segnalata l'impostazione internazionale predefinita) viene omessa, il PDI rimane idoneo alla pubblicazione.

Consulta i codici dei problemi relativi alle norme pertinenti qui: norme relative ai contenuti di testo della Ricerca Google

Violazione delle norme relative ai contenuti di testo della Ricerca Google - Indirizzo visualizzato

Codice problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravità: Avviso (non blocca la pubblicazione)
Campo interessato: display_address.localizations.*.text
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo avviso viene visualizzato quando il testo dell'indirizzo formattato in display_address.localizations contiene contenuti vietati dalle norme relative ai contenuti testuali della Ricerca Google. Anche se la localizzazione dell'indirizzo segnalato (o l'intero campo display_address se viene segnalata l'impostazione predefinita) viene omessa, il PDI rimane idoneo alla pubblicazione.

Consulta i codici dei problemi relativi alle norme pertinenti qui: norme relative ai contenuti di testo della Ricerca Google

L'orario di apertura dell'attività è successivo all'orario di chiusura

Codice problema: NOT_LESS_THAN_FIELD
Gravità: Errore (blocca la pubblicazione)
Campi interessati: local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo errore si verifica quando l'orario di apertura open_time è successivo o uguale a close_time per lo stesso intervallo di giorni.

Cause comuni e correzione:

Inversione nello stesso giorno:assicurati che open_time sia precedente a close_time (ad es. dalle 09:00 alle 17:00).
Turni notturni: se un'attività apre un giorno e chiude dopo la mezzanotte del giorno successivo (ad es. dalle 21:00 alle 02:00), imposta close_day sul giorno successivo (ad es. open_day: "FRIDAY", close_day: "SATURDAY").

Esempio di payload valido:

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

Il valore minimo della fascia di prezzo è maggiore del valore massimo

Codice problema: INVALID_PRICE_RANGE
Gravità: Errore (blocca la pubblicazione)
Campi interessati: local_data.price_range.min_price, local_data.price_range.max_price
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo errore si verifica quando il valore di min_price supera quello di max_price o se min_price e max_price specificano codici valuta diversi.

Cause comuni e correzione:

Valori invertiti: assicurati che min_price sia inferiore o uguale a max_price.
Mancata corrispondenza della valuta: verifica che sia min_price.currency_code sia max_price.currency_code corrispondano allo stesso codice valuta ISO 4217 di tre lettere (ad es. "USD").

Esempio di payload valido:

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

Proprietà univoca duplicata all'interno di un PDI

Codice problema: DUPLICATE_UNIQUE_PROPERTY
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (risolvi aggiornando il payload del feed)

Questo errore si verifica quando un campo o un elemento secondario che deve essere univoco in una singola entità del PDI contiene voci duplicate.

Controlla il riquadro Dettagli problema per identificare quale proprietà viola l'unicità:

1. ID brand duplicato all'interno di un PDI (`local_data.brand_landing_pages.brand_id`)

Causa: la stessa stringa brand_id viene visualizzata in più voci brand_landing_pages per un singolo PDI.
Correzione: raggruppa tutte le pagine di destinazione di quel brand in un unico oggetto brand_landing_pages.

Esempio di payload valido:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722"
      },
      {
        "brand_id": "brand_opentable",
        "default_url": "https://www.opentable.com/r/287722"
      }
    ]
  }
}

2. URL pagina di destinazione localizzata del brand duplicato (`local_data.brand_landing_pages.localized_landing_pages.url`)

Causa: lo stesso URL pagina di destinazione è definito più volte in localized_landing_pages per lo stesso brand.
Correzione: assicurati che ogni voce URL sia distinta o associa più impostazioni internazionali in un singolo array locales della voce URL.

Esempio di payload valido:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

3. Impostazioni internazionali della pagina di destinazione localizzata del brand duplicato (`local_data.brand_landing_pages.localized_landing_pages.locales`)

Causa: lo stesso codice della lingua (ad es. "en-US") viene ripetuto in più voci in localized_landing_pages per lo stesso brand.
Correzione: assegna ogni tag di impostazioni internazionali esattamente a una pagina di destinazione localizzata.

Esempio di payload valido:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US", "en-GB"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

URL del brand non valido o formattato in modo errato

Codice problema: INVALID_ATTRIBUTE_VALUE
Gravità: Errore (blocca la pubblicazione)
Ricorribile: No (risolvi aggiornando il payload del feed)
Campi interessati: local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

Questo errore si verifica quando un URL predefinito del brand o un URL pagina di destinazione localizzato non supera la convalida della sintassi dell'URI.

Requisiti:

Protocollo: deve specificare esplicitamente http:// o https:// (https:// è obbligatorio per la pubblicazione in produzione).
Sintassi: deve essere un URL valido, con codifica percentuale, conforme allo standard RFC 3986 e con un nome di dominio completo.

Esempio di payload valido:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com/en",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en/reservation",
            "locales": ["en-US"]
          }
        ]
      }
    ]
  }
}

Violazione delle norme relative ai contenuti testuali della Ricerca Google - Categoria dell'attività

Codice problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravità: avviso (non blocca la pubblicazione)
Ricorribile: no (risolvi aggiornando il payload del feed)
Campo interessato: local_data.establishment_category.localizations.*.text

Questo avviso viene visualizzato quando il testo localizzato della categoria dell'attività non supera i filtri dei contenuti automatici di SafeSearch. Anche se la localizzazione della categoria dell'attività segnalata (o l'intero campo establishment_category se è segnalata l'impostazione locale predefinita) viene omessa, il POI rimane idoneo alla pubblicazione.

Correzione:

Conformità alle norme:rimuovi o sostituisci il testo della categoria dell'attività segnalato con termini standard per la categoria dell'attività che rispettano le norme relative ai contenuti di testo della Ricerca Google.

Esempio di payload valido:

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}

Avanti

Corrispondenza delle entità PDI

Visualizzazione inventario Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Panoramica

Colonne della tabella di inventario

Visualizzazione dei dettagli dei PDI

1. Informazioni di base

2. Stato elaborazione

3. Informazioni sulla corrispondenza

4. JSON non elaborato

Workflow per problemi e valutazione

Tipi di problemi: con possibilità di ricorso e senza possibilità di ricorso

Catalogo dei problemi delle unità di aggregatori locali

Codici dei problemi

Campo obbligatorio mancante

1. ID PDI mancante (poi_id)

2. Impostazioni internazionali predefinite o nome localizzato mancanti (name)

3. Impostazioni internazionali predefinite o indirizzo localizzato mancanti (display_address)

4. Impostazioni internazionali predefinite o descrizione localizzata mancanti (description)

5. Coordinate geografiche mancanti (location.latitude / location.longitude)

6. Indirizzo postale strutturato mancante (location.address)

7. Impostazioni internazionali predefinite mancanti per la categoria dell'attività (local_data.establishment_category.default_locale)

8. Giorno di apertura dell'orario di apertura mancante (local_data.business_hours.time_ranges.open_day)

9. Ora di apertura dell'orario di apertura mancante (local_data.business_hours.time_ranges.open_time)

10. Giorno di chiusura dell'orario di apertura mancante (local_data.business_hours.time_ranges.close_day)

11. Ora di chiusura dell'orario di apertura mancante (local_data.business_hours.time_ranges.close_time)

12. ID brand mancante (local_data.brand_landing_pages.brand_id)

13. URL predefinito del brand mancante (local_data.brand_landing_pages.default_url)

14. URL pagina di destinazione localizzata del brand mancante (local_data.brand_landing_pages.localized_landing_pages.url)

15. Impostazioni internazionali della pagina di destinazione localizzata del brand mancanti (local_data.brand_landing_pages.localized_landing_pages.locales)

Numero massimo di immagini superato

Correzione:

Coordinate geografiche non valide

Cause comuni e correzione:

URL non valido o con formato non corretto

Requisiti:

Immagine non valida o non raggiungibile

Cause comuni e correzione:

ID PDI duplicato

Correzione:

Entità corrispondente duplicata

Come risolvere il problema:

Entità senza corrispondenza

Come risolvere il problema:

Violazione delle norme relative alle immagini della Ricerca Google

Violazione delle norme relative ai contenuti testuali della Ricerca Google - Nome

Violazione delle norme relative ai contenuti testuali della Ricerca Google - Descrizione

Violazione delle norme relative ai contenuti di testo della Ricerca Google - Indirizzo visualizzato

L'orario di apertura dell'attività è successivo all'orario di chiusura

Cause comuni e correzione:

Il valore minimo della fascia di prezzo è maggiore del valore massimo

Cause comuni e correzione:

Proprietà univoca duplicata all'interno di un PDI

1. ID brand duplicato all'interno di un PDI (local_data.brand_landing_pages.brand_id)

2. URL pagina di destinazione localizzata del brand duplicato (local_data.brand_landing_pages.localized_landing_pages.url)

3. Impostazioni internazionali della pagina di destinazione localizzata del brand duplicato (local_data.brand_landing_pages.localized_landing_pages.locales)

URL del brand non valido o formattato in modo errato

Requisiti:

Violazione delle norme relative ai contenuti testuali della Ricerca Google - Categoria dell'attività

Correzione:

Visualizzazione inventario

1. ID PDI mancante (`poi_id`)

2. Impostazioni internazionali predefinite o nome localizzato mancanti (`name`)

3. Impostazioni internazionali predefinite o indirizzo localizzato mancanti (`display_address`)

4. Impostazioni internazionali predefinite o descrizione localizzata mancanti (`description`)

5. Coordinate geografiche mancanti (`location.latitude` / `location.longitude`)

6. Indirizzo postale strutturato mancante (`location.address`)

7. Impostazioni internazionali predefinite mancanti per la categoria dell'attività (`local_data.establishment_category.default_locale`)

8. Giorno di apertura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.open_day`)

9. Ora di apertura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.open_time`)

10. Giorno di chiusura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.close_day`)

11. Ora di chiusura dell'orario di apertura mancante (`local_data.business_hours.time_ranges.close_time`)

12. ID brand mancante (`local_data.brand_landing_pages.brand_id`)

13. URL predefinito del brand mancante (`local_data.brand_landing_pages.default_url`)

14. URL pagina di destinazione localizzata del brand mancante (`local_data.brand_landing_pages.localized_landing_pages.url`)

15. Impostazioni internazionali della pagina di destinazione localizzata del brand mancanti (`local_data.brand_landing_pages.localized_landing_pages.locales`)

1. ID brand duplicato all'interno di un PDI (`local_data.brand_landing_pages.brand_id`)

2. URL pagina di destinazione localizzata del brand duplicato (`local_data.brand_landing_pages.localized_landing_pages.url`)

3. Impostazioni internazionali della pagina di destinazione localizzata del brand duplicato (`local_data.brand_landing_pages.localized_landing_pages.locales`)