Stiamo disattivando l'API On-Premises. Consulta il nostro documento Disattivazione API On-Premises per i dettagli e per scoprire come eseguire la migrazione alla nostra API Cloud di nuova generazione.

Impostazioni del profilo business

/v1/settings/business/profile

Utilizza l'endpoint /v1/settings/business/profile per configurare le seguenti impostazioni del profilo business: indirizzo aziendale, descrizione dell'attività, e-mail per contatto aziendale, settore aziendale e sito web aziendale.

Prima di iniziare

  • Devi usare l'account admin per accedere alle impostazioni del profilo business.

Recupero

Effettua una chiamata API GET per recuperare le impostazioni del profilo business.

Esempio

GET /v1/settings/business/profile

Una risposta corretta include l'oggetto profile contenente i dati del profilo business. Per ulteriori descrizioni dei dati, consulta la Lista dei parametri seguente.

{
   "settings": {
     "business": {
        "profile": {
          "address": "new-business-address",
          "description": "business-description",
          "email": "new-business-email",
          "vertical": "business-industry",
          "websites": [ "website-1", "website-2" ]
        }
      }
}

Se si verificano errori, consulta Messaggi di errore e di stato.

Aggiornare le impostazioni del profilo business

Effettua una chiamata API POST per aggiornare le impostazioni del profilo business.

Esempio

POST /v1/settings/business/profile
{
    "address": "your-business-address",
    "description": "your-business-description",
    "email": "your-business-email",
    "vertical": "your-business-industry",
    "websites": [ "your-website-1", "your-website-2" ]
}

Parametri

NomeDescrizione

address

tipo: stringa

Indirizzo dell'azienda. Massimo 256 caratteri.

description

tipo: stringa

Descrizione dell'azienda. Massimo 512 caratteri.

email

tipo: stringa

Indirizzo e-mail (in formato e-mail valido) per contattare l'azienda. Massimo 128 caratteri.

vertical

tipo: stringa

Settore dell'azienda. Deve essere uno di questi valori accettati:

  • Automotive
  • Beauty, Spa and Salon
  • Clothing and Apparel
  • Education
  • Entertainment
  • Event Planning and Service
  • Finance and Banking
  • Food and Grocery
  • Public Service
  • Hotel and Lodging
  • Medical and Health
  • Non-profit
  • Professional Services
  • Shopping and Retail
  • Travel and Transportation
  • Restaurant
  • Other

Il settore business non può essere reimpostato su un valore vuoto dopo che è stato creato.

websites

tipo: array di stringhe

URL (compreso http:// o https://) associati all'azienda (ad es. sito web, Pagina Facebook, Instagram). Massimo 2 siti web con un massimo di 256 caratteri ognuno.

Aggiornamenti parziali

Se devi aggiornare solo un paio di campi con nuove informazioni, puoi fare una richiesta che modifica solo i campi necessari:

  POST /v1/settings/business/profile
{
    "address": "new-business-address",
    "email": "new-business-email"
}

Una richiesta corretta restituisce il codice di stato HTTP 200 OK insieme a null o {}. Se si verificano errori, consulta Messaggi di errore e di stato.