Controlla lo stato delle modifiche per località e attributi

Quando aggiorni le informazioni sull'attività tramite l'API My Business Business Information o l'interfaccia utente di Profilo dell'attività, le modifiche passano attraverso una pipeline di moderazione e verifica prima di essere pubblicate su Ricerca Google e Maps. Inoltre, Google potrebbe aggiornare i dettagli dell'attività in base alle segnalazioni degli utenti o alle origini dati concesse in licenza.

Gli endpoint v1alpha Edit Status ti consentono di recuperare una visualizzazione unificata di una sede o dei suoi attributi in un'unica richiesta:

  • Dati forniti dal commerciante: i valori inviati per ultimi dal commerciante.
  • Dati rivolti ai consumatori: i valori vengono visualizzati nella Ricerca Google e su Maps.
  • Metadati dei campi estesi: stato di modifica per campo o per attributo, inclusa la fase del ciclo di vita dell'ultima modifica, l'origine (API o UI), il timestamp dell'ultima modifica e l'eventuale motivo della violazione delle norme se una modifica è stata rifiutata.

Prima di iniziare

Prima di utilizzare l'API My Business Business Information, registra la tua applicazione e ottieni le credenziali OAuth 2.0. Per maggiori dettagli su come iniziare, consulta Configurazione di base.

Recupera i dati sulla posizione estesi

Per esaminare i dati sulla posizione forniti dal commerciante, i dati sulla posizione rivolti ai consumatori e lo stato di modifica per campo di una posizione, chiama locations.getExtended.

A differenza di locations.get, locations.getExtended non richiede un parametro readMask e restituisce la risorsa ExtendedLocation completa.

Richiesta

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}:getExtended

Risposta

La risposta contiene tre campi di primo livello:

  • locationProvidedByMerchant: i dati Location gestiti dal commerciante.
  • locationSeenByConsumers: i dati Location visibili ai consumatori sulla Ricerca Google e su Maps.
  • extendedFieldData: una mappa dei nomi dei campi Location di primo livello in snake_case (ad esempio title, phone_numbers, website_uri, storefront_address o regular_hours) agli oggetti ExtendedFieldData. Le chiavi sono sempre nomi di campi di primo livello semplici, mai campi secondari nidificati.
{
  "locationProvidedByMerchant": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters - Best Coffee in Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "locationSeenByConsumers": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters",
    "phoneNumbers": {
      "primaryPhone": "+61 2 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "extendedFieldData": {
    "title": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_REJECTED",
      "rejectionReason": "MISREPRESENTATION",
      "updateTime": "2026-09-25T08:00:00Z",
      "source": "SOURCE_API"
    },
    "phone_numbers": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE",
      "updateTime": "2026-09-20T14:15:00Z",
      "source": "SOURCE_UI"
    },
    "website_uri": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
      "updateTime": "2026-09-15T10:30:00Z",
      "source": "SOURCE_API"
    }
  }
}

Recupera i dati degli attributi estesi

Per esaminare i valori forniti dal commerciante, i valori rivolti ai consumatori e lo stato di modifica degli attributi di una sede, chiama locations.attributes.getExtended.

Richiesta

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

Risposta

La risposta restituisce una risorsa ExtendedAttributes contenente un elenco di voci ExtendedAttribute. Ogni voce associa attributeProvidedByMerchant e attributeSeenByConsumers a un oggetto extendedFieldData per l'attributo:

{
  "name": "locations/{locationId}/attributes",
  "extendedAttributes": [
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
        "updateTime": "2026-09-10T12:00:00Z",
        "source": "SOURCE_API"
      }
    },
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "free_wi_fi"
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "paid_wi_fi"
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_PENDING",
        "updateTime": "2026-09-28T16:45:00Z",
        "source": "SOURCE_API"
      }
    }
  ]
}

Informazioni sui metadati dei campi estesi

Ogni oggetto ExtendedFieldData contiene i seguenti campi:

Campo Tipo Descrizione
lastEditLifecycleStage EditLifecycleStage Lo stato di moderazione o pubblicazione della modifica più recente apportata a questo campo o attributo.
rejectionReason PolicyViolation La violazione delle norme che ha causato il rifiuto della modifica. Compilato quando lastEditLifecycleStage è EDIT_LIFECYCLE_STAGE_REJECTED.
updateTime string (Timestamp) Il timestamp dell'ultimo invio di una modifica a questo campo o attributo (formato RFC 3339).
source Source La piattaforma di origine in cui il commerciante ha inviato la modifica (SOURCE_API o SOURCE_UI).

Modifica le fasi del ciclo di vita

L'enum EditLifecycleStage indica la fase del ciclo di vita di una modifica:

Valore Descrizione Azione consigliata
EDIT_LIFECYCLE_STAGE_ACCEPTED La modifica del commerciante è stata approvata ed è idonea alla pubblicazione. Nessuna azione richiesta.
EDIT_LIFECYCLE_STAGE_PENDING La modifica del commerciante è in fase di revisione e non è stata applicata alla scheda rivolta ai consumatori. Attendi il completamento della moderazione. Non inviare ripetutamente modifiche identiche mentre una modifica è in attesa.
EDIT_LIFECYCLE_STAGE_REJECTED La modifica del commerciante non è stata accettata. Controlla rejectionReason per il valore PolicyViolation specifico. Correggi la violazione delle norme sottostante e invia un nuovo aggiornamento utilizzando locations.patch o locations.updateAttributes.
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE Il valore rivolto ai consumatori è stato aggiornato da Google (ad esempio, da segnalazioni degli utenti o fonti esterne) e differisce dal valore fornito dal commerciante. Esamina il valore locationSeenByConsumers o attributeSeenByConsumers e accettalo o sostituiscilo. Consulta Gestisci gli aggiornamenti Google.
EDIT_LIFECYCLE_STAGE_DRAFT La modifica è stata salvata come bozza (ad esempio, in una sede non verificata) e non è pubblicata sulla Ricerca Google e su Maps. Completa la verifica della sede in modo che la scheda possa essere pubblicata.
EDIT_LIFECYCLE_STAGE_UNSPECIFIED La fase del ciclo di vita della modifica è sconosciuta o non specificata. Nessuno.

Modifica le fonti

L'enum Source identifica il canale attraverso il quale il commerciante ha inviato la modifica:

  • SOURCE_API: la modifica è stata inviata tramite l'API My Business Business Information.
  • SOURCE_UI: la modifica è stata inviata tramite l'interfaccia utente web o l'app mobile di Profilo dell'attività.
  • SOURCE_UNSPECIFIED: l'origine della modifica non è specificata.

Violazioni delle norme

Quando lastEditLifecycleStage è EDIT_LIFECYCLE_STAGE_REJECTED, il campo rejectionReason fornisce un valore enum PolicyViolation che spiega il motivo per cui la modifica è stata rifiutata. I motivi del rifiuto riguardano le seguenti aree (esempi):

  • Stato del profilo e dell'account: ACCOUNT_RESTRICTED_AND_SUSPENDED, ACCOUNT_RESTRICTED_AND_EDIT_REJECTED, ASSOCIATED_ACCOUNT_SUSPENDED, BUSINESS_INELIGIBLE, LOCATION_SUSPENDED, LOCATION_VERIFICATION_REQUIRED, OWNERSHIP_REVOKED, PO_BOX.
  • Limitazioni di modifica: EDITING_RESTRICTION, ILLEGAL_BUSINESS_HOURS_EDIT, IDENTITY_CHANGE, GEOGRAPHIC_LOCATION_CHANGE.
  • Norme relative ai contenuti: MISREPRESENTATION, OFF_TOPIC, PERSONAL_INFO, GIBBERISH_AND_REPETITIVE, OBSCENITY_AND_PROFANITY, GENERIC_QUALITY.

Per l'elenco completo dei valori e delle descrizioni degli enum, consulta la documentazione di riferimento di PolicyViolation.