Package google.mybusiness.v4

Indice

AccessControl

Questo servizio consente di gestire gli utenti che hanno accesso ad account e posizioni.

AcceptInvitation

rpc AcceptInvitation(AcceptInvitationRequest) returns (Empty)

Accetta l'invito specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

CreateAccountAdmin

rpc CreateAccountAdmin(CreateAccountAdminRequest) returns (Admin)

Invita l'utente specificato a diventare amministratore dell'account specificato. L'invitato deve accettare l'invito per ottenere l'accesso all'account. Vedi [AccettaInvito] [google.mybusiness.v4.AccettaInvito] per accettare un invito in modo programmatico.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

CreateLocationAdmin

rpc CreateLocationAdmin(CreateLocationAdminRequest) returns (Admin)

Invita l'utente specificato a diventare amministratore della località specificata. L'invitato deve accettare l'invito per ottenere l'accesso alla posizione. Vedi [AccettaInvito] [google.mybusiness.v4.AccettaInvito] per accettare un invito in modo programmatico.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeclineInvitation

rpc DeclineInvitation(DeclineInvitationRequest) returns (Empty)

Rifiuta l'invito specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteAccountAdmin

rpc DeleteAccountAdmin(DeleteAccountAdminRequest) returns (Empty)

Rimuove l'amministratore specificato dall'account specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteLocationAdmin

rpc DeleteLocationAdmin(DeleteLocationAdminRequest) returns (Empty)

Rimuove l'amministratore specificato come gestore della sede specificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListAccountAdmins

rpc ListAccountAdmins(ListAccountAdminsRequest) returns (ListAccountAdminsResponse)

Elenca gli amministratori dell'account specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListInvitations

rpc ListInvitations(ListInvitationsRequest) returns (ListInvitationsResponse)

Elenca gli inviti in attesa per l'account specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListLocationAdmins

rpc ListLocationAdmins(ListLocationAdminsRequest) returns (ListLocationAdminsResponse)

Elenca tutti gli amministratori per la sede specificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateAccountAdmin

rpc UpdateAccountAdmin(UpdateAccountAdminRequest) returns (Admin)

Aggiorna l'amministratore per l'amministratore account specificato. È possibile aggiornare solo il ruolo Admin dell'amministratore.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateLocationAdmin

rpc UpdateLocationAdmin(UpdateLocationAdminRequest) returns (Admin)

Aggiorna l'Amministratore per l'amministratore della località specificato. È possibile aggiornare solo il ruolo Admin dell'amministratore.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

Account

Questa API consente di gestire gli account aziendali su Google. Consente di gestire le risorse Account. Definisce il seguente modello di risorsa:

  • L'API ha una raccolta di Account risorse, denominata accounts/*

  • Per praticità, puoi utilizzare il sinonimo "io" anziché l'ID dell'account personale del chiamante autenticato. Esempi: GET /v4/accounts/me GET /v4/accounts/me/locations

CreateAccount

rpc CreateAccount(CreateAccountRequest) returns (Account)

Crea un account con il nome e il tipo specificati sotto l'elemento principale specificato.

  • Impossibile creare account personali e organizzazioni.
  • I gruppi utenti non possono essere creati con un account personale come proprietario principale.
  • I Gruppi di località non possono essere creati con un proprietario principale di un account personale se l'account personale si trova in un'organizzazione.
  • I gruppi di località non possono essere proprietari di gruppi di località.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteNotifications

rpc DeleteNotifications(DeleteNotificationsRequest) returns (Empty)

Cancella le impostazioni di notifica Pub/Sub per l'account.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GenerateAccountNumber

rpc GenerateAccountNumber(GenerateAccountNumberRequest) returns (Account)

Genera un numero di conto bancario per questo account. Non viene eseguito il provisioning del numero di conto bancario al momento della creazione di un account. Utilizza questa richiesta per creare un numero di conto bancario quando è richiesto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Recupera l'account specificato. Restituisce NOT_FOUND se l'account non esiste o se il chiamante non dispone dei diritti di accesso all'account.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetNotifications

rpc GetNotifications(GetNotificationsRequest) returns (Notifications)

Restituisce le impostazioni di notifica Pub/Sub per l'account.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Elenca tutti gli account dell'utente autenticato. Sono inclusi tutti gli account di proprietà dell'utente, nonché tutti gli account per i quali l'utente dispone di diritti di gestione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Aggiorna l'account aziendale specificato. Non è possibile aggiornare gli account personali con questo metodo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateNotifications

rpc UpdateNotifications(UpdateNotificationsRequest) returns (Notifications)

Configura le impostazioni di notifica Pub/Sub per l'account per indicare a Profilo dell'attività per quale argomento inviare notifiche Pub/Sub:

  • Nuove recensioni per le sedi gestite dall'account.
  • Recensioni aggiornate per le sedi gestite dall'account.
  • Nuovo GoogleUpdates per le sedi amministrate dall'account.

Un account avrà una sola risorsa per le impostazioni di notifica ed è possibile impostare un solo argomento Pub/Sub.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

BusinessCategories

Questa API consente la visibilità delle categorie supportate per le sedi dell'attività commerciale su Google. Puoi ottenere elenchi impaginati di tutte le categorie aziendali disponibili o eseguire ricerche in base a un termine specifico. Come riferimento, consulta la sezione relativa alle categorie di questo articolo: https://support.google.com/business/answer/3038177

BatchGetBusinessCategories

rpc BatchGetBusinessCategories(BatchGetBusinessCategoriesRequest) returns (BatchGetBusinessCategoriesResponse)

Restituisce un elenco di categorie di attività per la lingua e gli ID GConcept forniti.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListBusinessCategories

rpc ListBusinessCategories(ListBusinessCategoriesRequest) returns (ListBusinessCategoriesResponse)

Restituisce un elenco di categorie di attività. La ricerca corrisponderà al nome della categoria, ma non all'ID della categoria.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

BusinessMessagingService

Consente alle aziende di registrare le proprie sedi per l'invio di messaggi aziendali, in modo da attivare un canale di comunicazione per i consumatori che cercano la sede dell'attività. Per visualizzare ed eseguire azioni nei messaggi inviati all'attività da una sede, devi essere un MANAGER o un OWNER della sede.

Follower

Questa API espone l'API di gestione dei follower.

GetFollowersMetadata

rpc GetFollowersMetadata(GetFollowersMetadataRequest) returns (FollowersMetadata)

Visualizza le impostazioni dei follower per un luogo.

NOT_FOUND viene restituito se l'account o la località non esiste. PRECONDITION_FAILED viene restituito se la sede non è verificata né collegata a Maps.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

FoodMenuService

Questa API consente di recuperare e aggiornare i menu degli alimenti delle sedi delle attività commerciali.

Tieni presente che Location.PriceList rappresenta anche i "menu" ma con campi limitati. Condivide lo stesso spazio di archiviazione downstream di FoodMenus. Una volta terminata la migrazione a FoodMenuService, i clienti sconsigliamo vivamente di utilizzare Location.PriceList per aggiornare più i dati del menu, il che potrebbe causare una perdita di dati imprevista.

GetFoodMenus

rpc GetFoodMenus(GetFoodMenusRequest) returns (FoodMenus)

Restituisce i menu dei cibi di una località specifica. Chiamalo solo se location.location_state.can_have_food_menu è true.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateFoodMenus

rpc UpdateFoodMenus(UpdateFoodMenusRequest) returns (FoodMenus)

Consente di aggiornare i menu dei cibi di una località specifica. Chiamalo solo se location.location_state.can_have_food_menu è true.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GoogleLocations

Questa API consente l'accesso e la ricerca in GoogleLocation.

ListRecommendedGoogleLocations

rpc ListRecommendedGoogleLocations(ListRecommendedGoogleLocationsRequest) returns (ListRecommendedGoogleLocationsResponse)

Elenca tutti i GoogleLocation che sono stati consigliati all'account Profilo dell'attività specificato. I consigli vengono forniti solo per gli account personali e i gruppi di sedi; le richieste per tutti gli altri tipi di account genereranno un errore. I consigli per i gruppi di località si basano sulle località del gruppo.

I consigli per gli account personali si basano su tutte le sedi a cui l'utente ha accesso in Profilo dell'attività (incluse le sedi a cui può accedere tramite i gruppi di sedi) e sono un soprainsieme di tutti i consigli generati per l'utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ReportGoogleLocation

rpc ReportGoogleLocation(ReportGoogleLocationRequest) returns (Empty)

Segnala un GoogleLocation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

Cerca tutte le possibili località corrispondenti alla richiesta specificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

HealthProviderAttributesService

Questo servizio consente la gestione degli attributi del fornitore di servizi sanitari (ad es. un'assicurazione accettata da una località) collegati a una località.

GetHealthProviderAttributes

rpc GetHealthProviderAttributes(GetHealthProviderAttributesRequest) returns (HealthProviderAttributes)

Restituisce gli attributi del fornitore di servizi sanitari di una località specifica.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateHealthProviderAttributes

rpc UpdateHealthProviderAttributes(UpdateHealthProviderAttributesRequest) returns (HealthProviderAttributes)

Aggiorna gli attributi del fornitore di servizi sanitari di una località specifica.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

Approfondimenti

Genera report con informazioni dettagliate sui consumatori per una o più schede nei servizi Google. È possibile eseguire query sui dati aggregati per le metriche di base risalenti a un massimo di 18 mesi prima. Le metriche che supportano una suddivisione possono mostrare dati aggregati in questo intervallo suddivisi per giorno della settimana o ora del giorno. Le richieste di indicazioni stradali possono essere registrate in istantanee per un numero selezionato di giorni.

ReportLocalPostInsights

rpc ReportLocalPostInsights(ReportLocalPostInsightsRequest) returns (ReportLocalPostInsightsResponse)

Restituisce informazioni per un insieme di post locali associati a una singola scheda. Le metriche e il modo in cui vengono registrate sono le opzioni specificate nel protocollo di richiesta.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ReportLocationInsights

rpc ReportLocationInsights(ReportLocationInsightsRequest) returns (ReportLocationInsightsResponse)

Restituisce un report contenente approfondimenti su una o più metriche per località.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

InsuranceNetworkService

Questo servizio consente di ottenere tutte le reti assicurative supportate per le sedi delle attività sanitarie su Google.

ListInsuranceNetworks

rpc ListInsuranceNetworks(ListInsuranceNetworksRequest) returns (ListInsuranceNetworksResponse)

Restituisce un elenco di tutte le reti di assicurazioni supportate da Google.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

LocalPosts

Questa API espone l'API di gestione dei post locali.

CreateLocalPost

rpc CreateLocalPost(CreateLocalPostRequest) returns (LocalPost)

Crea un nuovo post locale associato alla posizione specificata e lo restituisce.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteLocalPost

rpc DeleteLocalPost(DeleteLocalPostRequest) returns (Empty)

Elimina un post locale. Restituisce NOT_FOUND se il post locale non esiste.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetLocalPost

rpc GetLocalPost(GetLocalPostRequest) returns (LocalPost)

Recupera il post locale specificato. Restituisce NOT_FOUND se il post locale non esiste.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListLocalPosts

rpc ListLocalPosts(ListLocalPostsRequest) returns (ListLocalPostsResponse)

Restituisce un elenco di post locali associati a una posizione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateLocalPost

rpc UpdateLocalPost(UpdateLocalPostRequest) returns (LocalPost)

Aggiorna il post locale specificato e restituisce il post locale aggiornato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

Località

Questa API consente di gestire le sedi dell'attività su Google. Consente di gestire le risorse Location. Definisce il seguente modello di risorsa:

  • L'API ha una raccolta di Account risorse, denominata accounts/*

  • Per praticità, puoi utilizzare il sinonimo "io" anziché l'ID dell'account personale del chiamante autenticato. Esempi: GET /v4/accounts/me GET /v4/accounts/me/locations

  • Ogni Account ha una raccolta di Location risorse, denominata accounts/*/locations/*

AssociateLocation

rpc AssociateLocation(AssociateLocationRequest) returns (Empty)

Associa una località a un ID luogo. Qualsiasi associazione precedente viene sovrascritta. Questa operazione è valida solo se la sede non è verificata. L'associazione deve essere valida, ossia essere visualizzata nell'elenco di FindMatchingLocations.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

BatchGetLocations

rpc BatchGetLocations(BatchGetLocationsRequest) returns (BatchGetLocationsResponse)

Recupera tutte le località specificate nell'account specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ClearLocationAssociation

rpc ClearLocationAssociation(ClearLocationAssociationRequest) returns (Empty)

Cancella l'associazione tra una località e il relativo ID. Questa operazione è valida solo se la sede non è verificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

Crea un nuovo location di proprietà dell'account specificato e lo restituisce.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

Elimina una località.

FindMatchingLocations

rpc FindMatchingLocations(FindMatchingLocationsRequest) returns (FindMatchingLocationsResponse)

Trova tutte le possibili località corrispondenti alla località specificata. Questa operazione è valida solo se la sede non è verificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

Restituisce la catena specificata. Restituisce NOT_FOUND se la catena non esiste.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetLocationRequest) returns (GoogleUpdatedLocation)

Recupera la versione aggiornata da Google della località specificata. Restituisce NOT_FOUND se la località non esiste.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

Recupera la località specificata. Restituisce NOT_FOUND se la località non esiste.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

Restituisce l'elenco degli attributi disponibili che sarebbero disponibili per una località con il paese e la categoria principali specificati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

Elenca le località dell'account specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

Cerca la catena in base al nome.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

TransferLocation

rpc TransferLocation(TransferLocationRequest) returns (Location)

Sposta una sede da un account di proprietà dell'utente a un altro account gestito dallo stesso utente. L'utente deve essere un proprietario dell'account a cui è attualmente associata la sede e deve anche essere almeno un gestore dell'account di destinazione. Restituisce la località con il nuovo nome della risorsa.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

Aggiorna la località specificata.

Le foto sono consentite soltanto in una sede che dispone di una pagina Google+.

Restituisce NOT_FOUND se la località non esiste.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

Media

Questo servizio consente la gestione dei contenuti multimediali (foto e video) collegati a una località.

CreateMediaItem

rpc CreateMediaItem(CreateMediaItemRequest) returns (MediaItem)

Crea un nuovo elemento multimediale per la posizione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteMediaItem

rpc DeleteMediaItem(DeleteMediaItemRequest) returns (Empty)

Elimina l'elemento multimediale specificato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetCustomerMediaItem

rpc GetCustomerMediaItem(GetCustomerMediaItemRequest) returns (MediaItem)

Restituisce i metadati per l'elemento multimediale del cliente richiesto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetMediaItem

rpc GetMediaItem(GetMediaItemRequest) returns (MediaItem)

Restituisce i metadati per l'elemento multimediale richiesto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListCustomerMediaItems

rpc ListCustomerMediaItems(ListCustomerMediaItemsRequest) returns (ListCustomerMediaItemsResponse)

Restituisce un elenco di elementi multimediali associati a una località che sono stati forniti dai clienti.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListMediaItems

rpc ListMediaItems(ListMediaItemsRequest) returns (ListMediaItemsResponse)

Restituisce un elenco di elementi multimediali associati a una posizione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

StartUploadMediaItemData

rpc StartUploadMediaItemData(StartUploadMediaItemDataRequest) returns (MediaItemDataRef)

Genera un MediaItemDataRef per il caricamento dell'elemento multimediale.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateMediaItem

rpc UpdateMediaItem(UpdateMediaItemRequest) returns (MediaItem)

Consente di aggiornare i metadati dell'elemento multimediale specificato. Questa categoria può essere utilizzata solo per aggiornare la categoria di un elemento multimediale, ad eccezione del fatto che la nuova categoria non può essere COVER o PROFILE.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

QuestionsAndAnswers

Questo servizio consente di gestire le domande e le risposte relative a un luogo. Le operazioni con domande e risposte sono valide solo per le sedi verificate.

CreateQuestion

rpc CreateQuestion(CreateQuestionRequest) returns (Question)

Aggiunge una domanda per la sede specificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteAnswer

rpc DeleteAnswer(DeleteAnswerRequest) returns (Empty)

Consente di eliminare la risposta scritta dall'utente corrente a una domanda.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteQuestion

rpc DeleteQuestion(DeleteQuestionRequest) returns (Empty)

Consente di eliminare una domanda specifica scritta dall'utente corrente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListAnswers

rpc ListAnswers(ListAnswersRequest) returns (ListAnswersResponse)

Restituisce l'elenco impaginato di risposte per una domanda specifica.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListQuestions

rpc ListQuestions(ListQuestionsRequest) returns (ListQuestionsResponse)

Restituisce l'elenco impaginato delle domande e alcune delle relative risposte per una posizione specificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateQuestion

rpc UpdateQuestion(UpdateQuestionRequest) returns (Question)

Aggiorna una domanda specifica scritta dall'utente corrente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpsertAnswer

rpc UpsertAnswer(UpsertAnswerRequest) returns (Answer)

Crea una risposta o aggiorna la risposta esistente scritta dall'utente per la domanda specificata. Un utente può creare una sola risposta per domanda.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

Recensioni

Questa API fornisce operazioni CRUD per le recensioni. google.mybusiness.v4.Reviews.

BatchGetReviews

rpc BatchGetReviews(BatchGetReviewsRequest) returns (BatchGetReviewsResponse)

Restituisce l'elenco impaginato delle recensioni per tutte le sedi specificate. Questa operazione è valida solo se le località specificate sono verificate.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DeleteReviewReply

rpc DeleteReviewReply(DeleteReviewReplyRequest) returns (Empty)

Elimina la risposta alla recensione specificata. Questa operazione è valida solo se la località specificata è verificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

GetReview

rpc GetReview(GetReviewRequest) returns (Review)

Restituisce la recensione specificata. Questa operazione è valida solo se la località specificata è verificata. Restituisce NOT_FOUND se la recensione non esiste o è stata eliminata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListReviews

rpc ListReviews(ListReviewsRequest) returns (ListReviewsResponse)

Restituisce l'elenco impaginato delle recensioni per la sede specificata. Questa operazione è valida solo se la località specificata è verificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateReviewReply

rpc UpdateReviewReply(UpdateReviewReplyRequest) returns (ReviewReply)

Aggiorna la risposta alla recensione specificata. Viene creata una risposta se non ne esiste una. Questa operazione è valida solo se la località specificata è verificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ServiceLists

Questa API consente alle operazioni di ottenere e aggiornare l'elenco dei servizi delle sedi delle attività commerciali su Google. Un elenco di servizi contiene un elenco di servizi forniti dai commercianti. Un servizio può essere un taglio di capelli, l'installazione di scaldabagni e così via.

GetServiceList

rpc GetServiceList(GetServiceListRequest) returns (ServiceList)

Recupera l'elenco di servizi specificato per una località.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UpdateServiceList

rpc UpdateServiceList(UpdateServiceListRequest) returns (ServiceList)

Aggiorna l'elenco di servizi specificato di una posizione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

Verifiche

Questa API consente di gestire le verifiche della posizione su Google. Consente di gestire le risorse Verification.

Ogni Location ha una raccolta di Verification risorse, denominata accounts/*/locations/*/verifications/*.

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

Completa una verifica di PENDING.

È necessario solo per i metodi di verifica diversi da AUTO. La richiesta di verifica di AUTO è immediatamente VERIFIED al momento della creazione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

Segnala tutte le opzioni di verifica idonee per una località in una lingua specifica.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

Elenca le verifiche di una sede, ordinate in base all'ora di creazione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

Avvia la procedura di verifica per una sede.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

AcceptInvitationRequest

Messaggio di richiesta per AccessControl.AccettaInvito.

Campi
name

string

Il nome dell'invito che viene accettato.

Account

Un account è un contenitore per le sedi della tua attività. Se sei l'unico utente che gestisce le sedi della tua attività, puoi utilizzare il tuo Account Google personale. Per condividere con più utenti la gestione delle sedi, crea un account aziendale.

Campi
name

string

Il nome della risorsa, nel formato accounts/{account_id}.

account_name

string

Il nome dell'account.

type

AccountType

Solo output. Specifica il valore AccountType di questo account.

role

AccountRole

Solo output. Specifica il valore AccountRole del chiamante per questo account.

state

AccountState

Solo output. Indica il AccountState di questo account.

account_number

string

Numero di riferimento dell'account, se fornito.

permission_level

PermissionLevel

Solo output. Specifica il valore PermissionLevel del chiamante per questo account.

organization_info

OrganizationInfo

Informazioni aggiuntive per un'organizzazione. Il campo viene compilato solo per un account dell'organizzazione.

OrganizationInfo

Informazioni aggiuntive archiviate per un'organizzazione.

Campi
registered_domain

string

Il dominio registrato per l'account.

postal_address

PostalAddress

L'indirizzo postale dell'account.

phone_number

string

Il numero di contatto dell'organizzazione.

AccountRole

Indica il livello di accesso dell'utente autenticato a questo account. Per saperne di più, consulta l'articolo del Centro assistenza

Enum
ACCOUNT_ROLE_UNSPECIFIED Non specificato.
OWNER Questo account è di proprietà dell'utente. (visualizzato come "Proprietario principale" nell'interfaccia utente).
CO_OWNER L'utente è un comproprietario dell'account. (visualizzato come "Proprietario" nell'interfaccia utente).
MANAGER L'utente può gestire questo account.
COMMUNITY_MANAGER L'utente può gestire pagine social (Google+) per l'account. (visualizza come ''Site Manager'' nell'interfaccia utente).

AccountState

Indica lo stato dell'account, ad esempio se è stato verificato da Google.

Campi
status

AccountStatus

Se verificate, le località future create vengono collegate automaticamente a Google Maps e vengono create pagine Google+ senza richiedere la moderazione.

AccountStatus

Indica lo stato di verifica dell'account.

Enum
ACCOUNT_STATUS_UNSPECIFIED Non specificato.
VERIFIED Account verificato.
UNVERIFIED Account che non è stato verificato e la verifica non è stata richiesta.
VERIFICATION_REQUESTED Account che non è stato verificato, ma è stata richiesta la verifica.

AccountType

Indica di che tipo di account si tratta: account personale/utente o account aziendale.

Enum
ACCOUNT_TYPE_UNSPECIFIED Non specificato.
PERSONAL Un account utente finale.
LOCATION_GROUP Un gruppo di località. Per saperne di più, consulta l'articolo del Centro assistenza
USER_GROUP Un gruppo di utenti per la separazione del personale dell'organizzazione in gruppi. Per saperne di più, consulta l'articolo del Centro assistenza
ORGANIZATION Un'organizzazione che rappresenta un'azienda. Per saperne di più, consulta l'articolo del Centro assistenza

AdWordsLocationExtensions

Informazioni aggiuntive visualizzate in AdWords.

Campi
ad_phone

string

Un numero di telefono alternativo da mostrare nelle estensioni di località AdWords anziché il numero di telefono principale della sede.

AddressInput

Input per la verifica di ADDRESS.

Campi
mailer_contact_name

string

Nome del contatto a cui inviare la posta.

Amministratore

Un amministratore di Account o Location.

Campi
name

string

Nome della risorsa. Per gli amministratori account, il formato è: accounts/{account_id}/admins/{admin_id}

Per gli amministratori delle sedi, il formato è: accounts/{account_id}/locations/{location_id}/admins/{admin_id}

admin_name

string

Il nome dell'amministratore. Quando si effettua l'invito iniziale, questo è l'indirizzo email dell'invitato. Per le chiamate GET, l'indirizzo email dell'utente viene restituito se l'invito è ancora in attesa. In caso contrario, conterrà nome e cognome dell'utente.

role

AdminRole

Specifica il valore AdminRole utilizzato da questo amministratore con la risorsa Account o Location specificata.

pending_invitation

bool

Solo output. Indica se questo amministratore ha un invito in attesa per la risorsa specificata.

AdminRole

Indica il livello di accesso di un amministratore. Per saperne di più, consulta l'articolo del Centro assistenza

Enum
ADMIN_ROLE_UNSPECIFIED Non specificato.
OWNER L'amministratore dispone dell'accesso a livello di proprietario ed è il proprietario principale. (visualizzato come "Proprietario principale" nell'interfaccia utente).
CO_OWNER L'amministratore dispone dell'accesso a livello di proprietario. (visualizzato come "Proprietario" nell'interfaccia utente).
MANAGER L'amministratore dispone dell'accesso manageriale.
COMMUNITY_MANAGER L'amministratore può gestire le pagine social (Google+). (visualizza come ''Site Manager'' nell'interfaccia utente).

AlertType

Il tipo di evento per cui è stato creato il post di avviso.

Enum
ALERT_TYPE_UNSPECIFIED Nessun avviso specificato.
COVID_19 Avvisi relativi alla pandemia di coronavirus del 2019. I post relativi al COVID-19 supportano solo un campo di riepilogo e un campo di invito all'azione. Quando questi avvisi non sono più pertinenti, verrà disattivata la creazione di nuovi post di avviso per il tipo COVID-19. Tuttavia, il commerciante potrà continuare a gestire i suoi post esistenti relativi al COVID-19.

Allergeni

Informazioni sugli allergeni relativi a un alimento.

Enum
ALLERGEN_UNSPECIFIED Allergene non specificato
DAIRY Allergene correlato ai latticini
EGG Allergene correlato alle uova
FISH Allergene correlato ai pesci
PEANUT Allergene correlato alle arachidi
SHELLFISH Allergene correlato ai crostacei
SOY Allergene correlato alla soia
TREE_NUT Allergene correlato alla frutta a guscio
WHEAT Allergene correlato al grano

Risposta

Rappresenta una risposta a una domanda

Campi
name

string

Solo output. Nome univoco delle risposte accounts/*/locations/*/questions/*/answers/*

author

Author

Solo output. L'autore della risposta.

upvote_count

int32

Solo output. Il numero di voti positivi per la risposta.

text

string

Il testo della risposta. Deve contenere almeno uno spazio non vuoto. La lunghezza massima è di 4096 caratteri.

create_time

Timestamp

Solo output. Il timestamp in cui è stata scritta la risposta.

update_time

Timestamp

Solo output. Il timestamp relativo all'ultima modifica della risposta.

AssociateLocationRequest

Messaggio di richiesta per locations.AssociateLocationRequest.

Campi
name

string

Il nome della risorsa della località da associare.

place_id

string

L'associazione da stabilire. Se non viene configurato, indica che non esistono corrispondenze.

Attributo

Un attributo località. Gli attributi forniscono informazioni aggiuntive su una località. Gli attributi che è possibile impostare su una località possono variare in base alle proprietà di questa località (ad esempio, categoria). Gli attributi disponibili sono determinati da Google e possono essere aggiunti e rimossi senza modifiche all'API.

Campi
attribute_id

string

L'ID dell'attributo. Gli ID degli attributi sono forniti da Google.

value_type

AttributeValueType

Solo output. Il tipo di valore contenuto in questo attributo. Dovrebbe essere utilizzato per determinare come interpretare il valore.

values[]

Value

I valori di questo attributo. Il tipo dei valori forniti deve corrispondere a quello previsto per l'attributo in questione. consulta AttributeValueType. Si tratta di un campo ripetuto in cui possono essere forniti più valori di attributi. I tipi di attributo supportano un solo valore.

repeated_enum_value

RepeatedEnumAttributeValue

Quando il tipo di valore dell'attributo è REPEATED_ENUM, contiene il valore dell'attributo e gli altri campi dei valori devono essere vuoti.

url_values[]

UrlAttributeValue

Se il tipo di valore dell'attributo è URL, questo campo contiene i valori per questo attributo e gli altri campi con i valori devono essere vuoti.

AttributeMetadata

Metadati relativi a un attributo. Contiene le informazioni di visualizzazione per l'attributo, tra cui un nome localizzato e un'intestazione per raggruppare gli attributi correlati.

Campi
attribute_id

string

L'ID dell'attributo.

value_type

AttributeValueType

Il tipo di valore dell'attributo. I valori impostati e recuperati dovrebbero essere di questo tipo.

display_name

string

Il nome visualizzato localizzato dell'attributo, se disponibile. altrimenti il nome visualizzato in inglese.

group_display_name

string

Il nome visualizzato localizzato del gruppo che contiene questo attributo, se disponibile. altrimenti il nome del gruppo in inglese. Gli attributi correlati vengono raccolti in un gruppo e devono essere visualizzati insieme sotto l'intestazione qui fornita.

is_repeatable

bool

Se true, l'attributo supporta più valori. Se false, è necessario fornire un solo valore.

value_metadata[]

AttributeValueMetadata

Per alcuni tipi di attributi (ad esempio le enum), viene fornito un elenco di valori supportati e dei relativi nomi visualizzati.

is_deprecated

bool

Se impostato su true, l'attributo è obsoleto e non deve più essere utilizzato. Se deprecato, l'aggiornamento di questo attributo non genererà un errore, ma gli aggiornamenti non verranno salvati. A un certo punto, dopo essere stato deprecato, l'attributo verrà rimosso completamente e diventerà un errore.

AttributeValueMetadata

Metadati per i valori degli attributi supportati.

Campi
value

Value

Il valore dell'attributo.

display_name

string

Il nome visualizzato di questo valore, localizzato dove disponibile; altrimenti in inglese. Il nome visualizzato del valore deve essere utilizzato nel contesto del nome visualizzato dell'attributo.

Ad esempio, per una connessione "Wi-Fi" attributo enum, potrebbe contenere "Pagato" per rappresentare le reti Wi-Fi a pagamento.

AttributeValueType

Il tipo di valore dell'attributo.

Enum
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED Non specificato.
BOOL I valori di questo attributo sono booleani.
ENUM L'attributo ha un elenco predeterminato di valori disponibili che è possibile utilizzare. I metadati per questo attributo elencheranno questi valori.
URL I valori per questo attributo sono URL.
REPEATED_ENUM Il valore dell'attributo è un'enumerazione con più valori possibili che è possibile impostare o annullare in modo esplicito.

Autore

Rappresenta l'autore di una domanda o risposta

Campi
display_name

string

Il nome visualizzato dell'utente

profile_photo_url

string

L'URL della foto del profilo dell'utente.

type

AuthorType

Il tipo di utente di cui è l'autore.

AuthorType

Enum per il tipo di utente di cui è l'autore.

Enum
AUTHOR_TYPE_UNSPECIFIED Non deve essere utilizzato.
REGULAR_USER Un utente normale.
LOCAL_GUIDE Una Local Guide
MERCHANT Il proprietario/gestore della sede

BasicMetricsRequest

Una richiesta di approfondimenti sulle metriche di base.

Campi
metric_requests[]

MetricRequest

Una raccolta di metriche per cui restituire valori per includere le opzioni di restituzione dei dati.

time_range

TimeRange

L'intervallo per il quale raccogliere le metriche. L'intervallo massimo è 18 mesi dalla data della richiesta. In alcuni casi, i dati potrebbero non essere ancora disponibili per i giorni successivi alla data della richiesta. I dati mancanti verranno specificati nel campo metricValues della risposta.

BatchGetBusinessCategoriesRequest

Messaggio di richiesta per BusinessCategories.BatchGetBusinessCategories.

Campi
language_code

string

Obbligatorio. Il codice BCP 47 del linguaggio in cui devono essere restituiti i nomi delle categorie.

category_ids[]

string

Obbligatorio. Devi impostare almeno un nome. Gli ID di GConcept per i quali devono essere restituiti i nomi delle categorie localizzate.

region_code

string

(Facoltativo) Il codice paese ISO 3166-1 alpha-2 utilizzato per dedurre un linguaggio non standard.

view

CategoryView

Obbligatorio. Specifica le parti della risorsa Categoria da restituire nella risposta.

BatchGetBusinessCategoriesResponse

Messaggio di risposta per BusinessCategories.BatchGetBusinessCategories.

Campi
categories[]

Category

Categorie che corrispondono agli ID GConcept forniti nella richiesta. Non saranno nello stesso ordine degli ID categoria nella richiesta.

BatchGetLocationsRequest

Messaggio di richiesta per locations.BatchGetLocations.

Campi
name

string

Il nome dell'account da cui recuperare le sedi.

location_names[]

string

Una raccolta di posizioni da recuperare, specificate dai loro nomi.

BatchGetLocationsResponse

Messaggio di risposta per locations.BatchGetLocations.

Campi
locations[]

Location

Un insieme di località.

BatchGetReviewsRequest

Messaggio di richiesta per Reviews.BatchGetReviews.

Campi
name

string

Il nome dell'account da cui recuperare un elenco di recensioni in più sedi.

location_names[]

string

Una raccolta di sedi per cui recuperare le recensioni, specificate dai nomi.

page_size

int32

Numero di recensioni da recuperare per pagina. Il valore predefinito è 50.

page_token

string

Se specificato, consente di recuperare la pagina successiva di recensioni.

order_by

string

(Facoltativo) Specifica il campo in base al quale ordinare le recensioni. Se non viene specificato, l'ordine delle recensioni restituite verrà impostato sul valore predefinito update_time desc. Gli ordini validi per l'ordinamento sono rating, rating desc e update_time desc. rating restituirà le recensioni in ordine crescente. update_time(ordine crescente) non supportato.

ignore_rating_only_reviews

bool

Indica se ignorare le recensioni con solo valutazioni.

BatchGetReviewsResponse

Messaggio di risposta per Reviews.BatchGetReviews.

Campi
location_reviews[]

LocationReview

Recensioni con informazioni sulla posizione.

next_page_token

string

Se il numero di recensioni supera le dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di recensioni in una chiamata successiva. Se non ci sono altre revisioni, questo campo non sarà presente nella risposta.

BusinessHours

Rappresenta i periodi di tempo in cui questa sede è aperta alle attività. Contiene una raccolta di TimePeriod istanze.

Campi
periods[]

TimePeriod

Una raccolta degli orari di apertura di questa sede. Ogni periodo rappresenta un intervallo di orari in cui la sede è aperta durante la settimana.

CallToAction

Un'azione che viene eseguita quando l'utente fa clic sul post.

Campi
action_type

ActionType

Il tipo di azione che verrà eseguita.

url

string

L'URL a cui verrà indirizzato l'utente quando fa clic. Questo campo non deve essere impostato per l'invito all'azione di chiamata.

ActionType

Il tipo di azione che verrà eseguita.

Enum
ACTION_TYPE_UNSPECIFIED Tipo non specificato.
BOOK Questo post richiede che un utente prenoti un appuntamento, un tavolo e così via.
ORDER Questo post richiede all'utente di ordinare qualcosa.
SHOP Questo post vuole che un utente sfogli il catalogo di un prodotto.
LEARN_MORE Questo post vuole che l'utente riceva ulteriori informazioni (sul proprio sito web).
SIGN_UP Questo post richiede che un utente si registri/si iscriva o partecipi a qualcosa.
GET_OFFER

Deprecato. Usa OFFER in LocalPostTopicType per creare un post con contenuti dell'offerta.

CALL Questo post richiede che un utente chiami l'attività.

Categoria

Una categoria che descrive l'attività (non quello che fa). Per un elenco di ID categoria validi e le mappature ai relativi nomi leggibili, consulta categories.list.

Campi
display_name

string

di Google. Il nome leggibile della categoria. Viene impostato durante la lettura della posizione. Quando modifichi la località, è necessario impostare category_id.

Nota: questo campo viene utilizzato solo nelle risposte. Qualsiasi valore specificato qui in una richiesta viene ignorato.

category_id

string

di Google. Un ID fisso (fornito da Google) per questa categoria. È necessario specificare category_id durante la modifica della categoria (durante la creazione o l'aggiornamento di una località).

Nota: questo campo viene utilizzato solo nelle risposte. Qualsiasi valore specificato qui in una richiesta viene ignorato.

service_types[]

ServiceType

di Google. Un elenco di tutti i tipi di servizi disponibili per questa categoria dell'attività.

Nota: questo campo viene utilizzato solo nelle risposte. Qualsiasi valore specificato qui in una richiesta viene ignorato.

more_hours_types[]

MoreHoursType

Solo output. Altri tipi di orari disponibili per questa categoria dell'attività.

CategoryView

Un'enumerazione che consente di limitare la quantità di dati restituiti dal server.

Enum
CATEGORY_VIEW_UNSPECIFIED Non specificato, equivalente a CATEGORY_METADATA_ONLY.
BASIC La risposta del server includerà solo i campi Categoria display_name, category_id e language_code. Vengono omessi tutti i campi relativi ai metadati dei tipi di servizio.
FULL Restituisce tutti i campi della risposta.

Catena

Una catena è un brand con cui possono essere affiliate le sedi della tua attività.

Campi
name

string

Il nome della risorsa della catena, nel formato chains/{chain_place_id}.

chain_names[]

ChainName

Nomi della catena.

websites[]

ChainUrl

Siti web della catena.

location_count

int32

Numero di sedi che fanno parte di questa catena.

ChainName

Nome da utilizzare durante la visualizzazione della catena.

Campi
display_name

string

Il nome visualizzato di questa catena.

language_code

string

Il codice BCP 47 della lingua del nome.

ChainUrl

URL da utilizzare per la visualizzazione della catena.

Campi
url

string

L'URL di questa catena.

ClearLocationAssociationRequest

Messaggio di richiesta per locations.ClearLocationAssociationRequest.

Campi
name

string

Il nome della risorsa della località di cui annullare l'associazione.

CompleteVerificationRequest

Messaggio di richiesta per Verifications.CompleteVerifyAction.

Campi
name

string

Nome della risorsa della verifica da completare.

pin

string

Codice PIN ricevuto dal commerciante per completare la verifica.

CompleteVerificationResponse

Messaggio di risposta relativo a Verifications.CompleteVerifyAction.

Campi
verification

Verification

La verifica è stata completata.

CreateAccountAdminRequest

Messaggio di richiesta per AccessControl.CreateAccountAdmin.

Campi
parent

string

Il nome della risorsa dell'account per il quale è stato creato questo amministratore.

admin

Admin

L'amministratore che crea

CreateAccountRequest

Messaggio di richiesta per Accounts.CreateAccount.

Campi
primary_owner

string

Il nome della risorsa dell'account che sarà il proprietario principale dell'account in fase di creazione. Deve avere il formato accounts/{account_id}/.

account

Account

Dati per l'account da creare. Gli unici campi consentiti sono account_name e type.

CreateLocalPostRequest

Messaggio di richiesta per CreateLocalPost.

Campi
parent

string

Il nome della posizione in cui creare il post locale.

local_post

LocalPost

I nuovi metadati del post locale.

CreateLocationAdminRequest

Messaggio di richiesta per AccessControl.CreateLocationAdmin.

Campi
parent

string

Il nome della risorsa della località per cui è stato creato questo amministratore.

admin

Admin

L'amministratore che crea

CreateLocationRequest

Messaggio di richiesta per locations.CreateLocation.

Campi
parent

string

Il nome dell'account in cui creare la sede.

location

Location

I nuovi metadati sulla posizione.

validate_only

bool

Se true, la richiesta viene convalidata senza creare effettivamente la località.

request_id

string

Un ID richiesta univoco per il server per rilevare le richieste duplicate. Ti consigliamo di utilizzare gli UUID. La lunghezza massima è di 50 caratteri.

CreateMediaItemRequest

Messaggio di richiesta per Media.CreateMediaItem.

Campi
parent

string

Il nome della risorsa della posizione in cui verrà creato questo elemento multimediale.

media_item

MediaItem

L'elemento multimediale da creare.

CreateQuestionRequest

Messaggio di richiesta per questionsAndAnswers.CreateQuestion

Campi
parent

string

Il nome del luogo per cui scrivere una domanda.

question

Question

La nuova domanda.

DeclineInvitationRequest

Messaggio di richiesta per AccessControl.RifiutaInvito.

Campi
name

string

Il nome dell'invito all'account che viene rifiutato.

DeleteAccountAdminRequest

Messaggio di richiesta per AccessControl.DeleteAccountAdmin.

Campi
name

string

Il nome della risorsa dell'amministratore da rimuovere dall'account.

DeleteAnswerRequest

Messaggio di richiesta per questionsAndAnswers.DeleteAnswer

Campi
parent

string

Il nome della domanda per cui eliminare una risposta.

DeleteLocalPostRequest

Messaggio di richiesta per DeleteLocalPost.

Campi
name

string

Il nome del post locale da eliminare.

DeleteLocationAdminRequest

Messaggio di richiesta per AccessControl.DeleteLocationAdmin.

Campi
name

string

Il nome della risorsa dell'amministratore da rimuovere dalla località.

DeleteLocationRequest

Messaggio di richiesta per locations.DeleteLocation.

Campi
name

string

Il nome della località da eliminare.

DeleteMediaItemRequest

Messaggio di richiesta per Media.DeleteMediaItem.

Campi
name

string

Il nome dell'elemento multimediale da eliminare.

DeleteNotificationsRequest

Richiesta di un messaggio per Accounts.Deletenotifications.

Campi
name

string

Il nome della risorsa per le impostazioni di notifica da cancellare.

DeleteQuestionRequest

Messaggio di richiesta per questionsAndAnswers.DeleteQuestion

Campi
name

string

Il nome della domanda da eliminare.

DeleteReviewReplyRequest

Messaggio di richiesta per Reviews.DeleteReviewReview.

Campi
name

string

Il nome della risposta alla recensione da eliminare.

DietaryRestriction

Informazioni sull'alimentazione di un alimento.

Enum
DIETARY_RESTRICTION_UNSPECIFIED Tipo di dieta non specificato
HALAL Denozione del cibo come piatto halal.
KOSHER Denominazione del cibo in qualità di piatto kosher.
ORGANIC Denominazione del cibo come piatto biologico.
VEGAN Denominazione del cibo come piatto vegano.
VEGETARIAN Denominazione del cibo come piatto vegetariano.

DimensionalMetricValue

Un valore di una singola metrica con una determinata dimensione temporale.

Campi
metric_option

MetricOption

L'opzione che ha richiesto questo valore dimensionale.

time_dimension

TimeDimension

La dimensione del valore.

value

Int64Value

Il valore. Se non viene impostato alcun valore, i dati richiesti non sono disponibili.

TimeDimension

La dimensione per la quale vengono suddivisi i dati.

Campi
day_of_week

DayOfWeek

Il giorno della settimana (da "MONDAY" a "SUNDAY") a cui corrisponde questo valore. Impostato per l'opzione BREAKDOWN_DAY_OF_WEEK.

time_of_day

TimeOfDay

L'ora del giorno (da 0 a 23) a cui corrisponde questo valore. Impostato per l'opzione BREAKDOWN_hour_OF_DAY.

time_range

TimeRange

L'intervallo di tempo coperto da questo valore. Impostato per le opzioni AGGREGATED_TOTAL e AGGREGATED_DAILY.

DrivingDirectionMetricsRequest

Richiesta di informazioni sulle indicazioni stradali.

Campi
num_days

NumDays

Il numero di giorni per i quali aggregare i dati. I risultati restituiti saranno dati disponibili relativi all'ultimo numero di giorni richiesti. I valori validi sono 7, 30 e 90.

language_code

string

Il codice BCP 47 per la lingua. Se non viene fornito un codice lingua, per impostazione predefinita viene utilizzato l'inglese.

NumDays

Numero di giorni supportati da questa richiesta.

Enum
SEVEN 7 giorni. Questo è il valore predefinito.
THIRTY 30 giorni.
NINETY per 90 giorni.

EmailInput

Input per la verifica tramite EMAIL.

Campi
email_address

string

Indirizzo email a cui inviare il PIN.

Un indirizzo email viene accettato solo se è uno degli indirizzi forniti da FetchVerificaOptions. Se il parametro EmailVerificationData è impostato su true, il client può specificare un nome utente diverso (local-part), ma deve corrispondere al nome di dominio.

ErrorDetail

Indica in dettaglio un errore che ha generato una convalida o un errore interno.

Campi
code

int32

Il codice di stato, che deve essere un valore enum pari a ErrorCode.

field

string

Un percorso che rimanda a un campo nel corpo della richiesta. Il valore è una sequenza di identificatori separati da punti che identificano un campo del buffer di protocollo. Ad esempio, "error_details.field" identificherà questo campo.

message

string

Una descrizione del motivo per cui il campo ha causato un errore. Il messaggio è in inglese e potrebbe non essere adatto per essere mostrato agli utenti.

value

string

Il valore che non ha soddisfatto la richiesta.

field_index

int32

Se il campo di richiesta che ha generato questo errore viene ripetuto, conterrà l'indice su base zero della voce in quel campo che ha causato la mancata riuscita della convalida.

ErrorCode

Codici di errore per ErrorDetail:

  • Da 1 a 199: codici di errore comuni che si applicano a tutti i campi.
  • Da 1000 a 1099: codici di errore relativi alle foto.
  • Da 1100 a 1199: codici di errore relativi a indirizzo e latitudine/longitudine.
  • Da 1200 a 1299: codici di errore relativi alla categoria.
  • Da 1300 a 1399: codici di errore relativi all'operazione.

Enum
ERROR_CODE_UNSPECIFIED Codice di errore catch-all.
MISSING_VALUE Non è stato fornito un valore obbligatorio.
INVALID_VALUE È stato fornito un valore non valido.
INVALID_CHARACTERS Sono stati trovati caratteri non validi.
TOO_MANY_ITEMS In un campo ripetuto è stato specificato un numero di elementi superiore al numero massimo consentito.
READ_ONLY Impossibile modificare il campo di sola lettura.
OVERLAPPING_RANGES Gli elementi in un campo ripetuto sono intervalli che si sovrappongono tra loro.
INVERTED_RANGE L'intervallo specificato è invertito. È incluso anche il caso di un intervallo vuoto.
VALUE_OUTSIDE_ALLOWED_RANGE Il valore specificato non rientra nell'intervallo consentito.
MISSING_DEPENDENT_FIELD Campo dipendente obbligatorio non presente.
FIELD_HAS_DEPENDENCIES Campo obbligatorio per un campo dipendente e non può essere rimosso.
UNSUPPORTED_VALUE Il valore fornito, sebbene potenzialmente valido, non è supportato a causa di altri vincoli.
EXPIRED_VALUE Il valore fornito è scaduto e non è più valido.
PHOTO_FETCH_FAILED Recupero della foto dall'URL specificato non riuscito.
PHOTO_UPLOAD_FAILED Caricamento della foto dall'URL specificato non riuscito.
GEOCODE_ERROR Si è verificato un errore durante la determinazione automatica della latitudine/longitudine.
LAT_LNG_OUTSIDE_COUNTRY La latitudine/longitudine fornita non corrisponde al paese indicato.
LAT_LNG_REQUIRED Devi specificare latitudine e longitudine.
LAT_LNG_TOO_FAR_FROM_ADDRESS La coppia di latitudine/longitudine e indirizzo è troppo distante.
CATEGORY_NOT_VERIFIED La categoria specificata non è verificata.
OPERATION_EXECUTION_ERROR Errore di esecuzione dell'operazione generico.
OPERATION_UNSUPPORTED_UNDER_ACCOUNT_CONDITION L'operazione non è supportata a causa della condizione dell'account.
LOCATION_DISABLED_FOR_LOCAL_POST_API Località disattivata per l'API Local Post.

FetchVerificationOptionsRequest

Messaggio di richiesta per Verifications.FetchVerificaOptions.

Campi
name

string

Nome risorsa della località da verificare.

language_code

string

Il codice lingua BCP 47 che rappresenta la lingua da utilizzare per la procedura di verifica. Le opzioni disponibili variano in base alla lingua.

context

ServiceBusinessContext

Informazioni contestuali aggiuntive per la verifica delle attività di servizi. Obbligatorio per le sedi il cui tipo di attività è CUSTOMER_LOCATION_ONLY. Se è impostato per altri tipi di località di attività commerciali, verrà visualizzato il valore INVALID_ARGUMENT.

FetchVerificationOptionsResponse

Messaggio di risposta relativo a Verifications.FetchVerificationOptions.

Campi
options[]

VerificationOption

Le opzioni di verifica disponibili.

FindMatchingLocationsRequest

Messaggio di richiesta per locations.FindMatchingLocations.

Campi
name

string

Il nome della risorsa della località per cui trovare corrispondenze.

language_code

string

La lingua preferita per la località corrispondente (nel formato BCP-47).

num_results

int32

Il numero di corrispondenze da restituire. Il valore predefinito è 3, con un massimo di 10. Tieni presente che, se vengono richieste altre, la latenza può aumentare. Non è prevista l'impaginazione.

max_cache_duration

Duration

Deprecato. Questo campo viene ignorato per tutte le richieste.

FindMatchingLocationsResponse

Messaggio di risposta per locations.FindMatchingLocations.

Campi
matched_locations[]

MatchedLocation

Un insieme di località che potrebbero corrispondere alla località specificata, ordinate dalla migliore alla meno corrispondente. Se c'è una corrispondenza esatta, l'annuncio si trova nella prima posizione.

match_time

Timestamp

Data/ora dell'ultima esecuzione dell'algoritmo di corrispondenza per questa località.

FollowersMetadata

Metadati dei follower per una località.

Campi
name

string

Nome della risorsa per questo elemento. accounts/{account_id}/locations/{location_id}/followers/metadata

count

uint64

Numero totale di follower per la località.

FoodMenu

Menu di un'attività che serve piatti alimentari.

Campi
labels[]

MenuLabel

Obbligatorio. Etichette con tag lingua per il menu. Ad es. "menu", "Speciale pranzo". I nomi visualizzati devono contenere al massimo 140 caratteri, mentre le descrizioni non devono superare i 1000 caratteri. È richiesto almeno un set di etichette.

source_url

string

(Facoltativo) URL di origine del menu se c'è una pagina web a cui andare.

sections[]

FoodMenuSection

Obbligatorio. Sezioni del menu.

cuisines[]

Cuisine

(Facoltativo) Informazioni sulla cucina per il menù. Ti consigliamo vivamente di fornire questo campo.

Cucina

Informazioni sulla cucina di un ristorante.

Enum
CUISINE_UNSPECIFIED Cucina non specificata
AMERICAN Cucina americana
ASIAN la cucina asiatica
BRAZILIAN la cucina brasiliana
BREAK_FAST Colazione
BRUNCH Brunch
CHICKEN Pollo
CHINESE Cucina cinese
FAMILY Cucina in stile familiare
FAST_FOOD Fast food
FRENCH Cucina francese
GREEK la cucina greca
GERMAN la cucina tedesca
HAMBURGER Hamburger
INDIAN Cucina indiana
INDONESIAN la cucina indonesiana
ITALIAN Cucina italiana
JAPANESE Cucina giapponese
KOREAN Cucina coreana
LATIN_AMERICAN Cucina latinoamericana
MEDITERRANEAN la cucina mediterranea
MEXICAN Cucina messicana
PAKISTANI la cucina pakistana
PIZZA Pizza
SEAFOOD Pesce
SPANISH la cucina spagnola
SUSHI Sushi
THAI la cucina tailandese
TURKISH la cucina turca
VEGETARIAN Cucina vegetariana
VIETNAMESE la cucina vietnamita
OTHER_CUISINE Altra cucina

FoodMenuItem

Elemento di una Sezione. Può essere il piatto stesso o può contenere più FoodMenuItemOption.

Campi
labels[]

MenuLabel

Obbligatorio. Etichette con tag di lingua per questa voce di menu. I nomi visualizzati devono contenere al massimo 140 caratteri, mentre le descrizioni non devono superare i 1000 caratteri. È richiesto almeno un set di etichette.

attributes

FoodMenuItemAttributes

Obbligatorio. Attributi dettagliati dell'articolo. Quando vengono specificate le opzioni elemento, questo viene considerato come attributi di base e viene compilato con ogni opzione.

options[]

FoodMenuItemOption

(Facoltativo) Si tratta di un articolo che è disponibile in più opzioni diverse e gli utenti sono tenuti a fare delle scelte. Ad es. "regolare" e "grandi" pizza. Quando vengono specificate le opzioni, le etichette e gli attributi a livello di articolo diventeranno automaticamente le etichette e gli attributi della prima opzione. I clienti devono solo specificare altre opzioni alimentari aggiuntive in questo campo.

FoodMenuItemAttributes

Attributi di un alimento/piatto.

Campi
price

Money

Obbligatorio. Prezzo del piatto.

spiciness

Spiciness

(Facoltativo) Livello di piccantezza del piatto.

allergen[]

Allergen

(Facoltativo) Allergeni associati al piatto alimentare. Ti consigliamo vivamente di fornire questo campo.

dietary_restriction[]

DietaryRestriction

(Facoltativo) Informazioni sull'alimentazione del piatto. Ti consigliamo vivamente di fornire questo campo.

nutrition_facts

NutritionFacts

(Facoltativo) Dati nutrizionali dell'opzione del piatto. Ti consigliamo vivamente di fornire questo campo.

ingredients[]

Ingredient

(Facoltativo) Ingredienti dell'opzione per i piatti.

serves_num_people

int32

(Facoltativo) Questo piatto indica il numero di persone che può essere servito.

preparation_methods[]

PreparationMethod

(Facoltativo) Metodi di preparazione del piatto.

portion_size

PortionSize

(Facoltativo) Dimensione dell'ordine, rappresentata in unità di articoli. (ad es. 4 "spiedini", 6 "pezzi")

media_keys[]

string

(Facoltativo) I tasti multimediali dei contenuti multimediali associati al piatto. Sono supportati solo i contenuti multimediali per le foto. Quando sono associate più foto, la prima foto viene considerata come preferita.

Ingrediente

Questo messaggio indica le informazioni sugli ingredienti di un piatto.

Campi
labels[]

MenuLabel

Obbligatorio. Etichette per descrivere l'ingrediente. I nomi visualizzati devono contenere al massimo 140 caratteri, mentre le descrizioni non devono superare i 1000 caratteri. È richiesto almeno un set di etichette.

PortionSize

Porre le porzioni di un piatto.

Campi
quantity

int32

Obbligatorio. Numero della porzione.

unit[]

MenuLabel

Obbligatorio. Il campo name_info ripetuto riguarda l'unità in più lingue.

FoodMenuItemOption

Opzione di un articolo. Richiede una selezione esplicita dell'utente.

Campi
labels[]

MenuLabel

Obbligatorio. Etichette con tag di lingua per questa opzione di voce di menu. ad esempio: "beef pad thai", "veggie pad thai", "pizza piccola", "pizza grande". I nomi visualizzati devono contenere al massimo 140 caratteri, mentre le descrizioni non devono superare i 1000 caratteri. È richiesto almeno un set di etichette.

attributes

FoodMenuItemAttributes

Obbligatorio. Attributi dettagliati dell'opzione articolo. I singoli attributi non specificati verranno ereditati dagli attributi a livello di articolo come base.

FoodMenuSection

Sezione di un menu. Può contenere più piatti/piatti.

Campi
labels[]

MenuLabel

Obbligatorio. Etichette con tag di lingua per questa sezione del menu. I nomi visualizzati devono contenere al massimo 140 caratteri, mentre le descrizioni non devono superare i 1000 caratteri. È richiesto almeno un set di etichette.

items[]

FoodMenuItem

Obbligatorio. Elementi della sezione. Ogni Sezione deve contenere almeno un elemento.

FoodMenus

Menù di un'attività che serve piatti alimentari.

Campi
name

string

Obbligatorio. Identificatore Google di questa sede nel formato: accounts/{account_id}/locations/{location_id}/foodMenus

menus[]

FoodMenu

(Facoltativo) Una raccolta di menù di cibo.

GenerateAccountNumberRequest

Messaggio di richiesta per Accounts.GenerateAccountNumber.

Campi
name

string

Il nome dell'account per il quale generare un numero di conto bancario.

GetAccountRequest

Messaggio di richiesta per Accounts.GetAccount.

Campi
name

string

Il nome dell'account da recuperare.

GetChainRequest

Messaggio di richiesta per locations.GetChain.

Campi
name

string

Il nome della risorsa della catena, nel formato chains/{chain_place_id}.

GetCustomerMediaItemRequest

Messaggio di richiesta per Media.GetCustomerMediaItem.

Campi
name

string

Il nome della risorsa dell'elemento multimediale del cliente richiesto.

GetFollowersMetadataRequest

Richiedi un messaggio per ottenere i metadati dei follower per un luogo.

Campi
name

string

Il nome della risorsa dei metadati dei follower della località. accounts/{account_id}/locations/{location_id}/followers/metadata

GetFoodMenusRequest

Messaggio di richiesta per FoodMenu.GetFoodMenus

Campi
name

string

Obbligatorio. Identificatore Google di questa sede nel formato: accounts/{account_id}/locations/{location_id}/foodMenus

read_mask

FieldMask

(Facoltativo) I campi specifici da restituire. Se non viene specificata alcuna maschera, viene restituito l'intero FoodMenu (equivalente a "*"). Gli elementi dei campi ripetuti non possono essere specificati singolarmente. Ad esempio: "nome". e "menus" sono maschere valide, mentre "menus.sections" non è valido.

GetHealthProviderAttributesRequest

Messaggio di richiesta per HealthProviderAttributes.GetHealthProviderAttributes

Campi
name

string

Obbligatorio. Identificatore Google di questa località nel formato: accounts/{account_id}/locations/{location_id}/healthProviderAttributes

language_code

string

(Facoltativo) Il codice BCP 47 per la lingua. Se non viene fornito un codice lingua, per impostazione predefinita viene utilizzato l'inglese. Per ora solo "en" è supportato.

GetLocalPostRequest

Messaggio di richiesta per LocalPosts.GetLocalPost.

Campi
name

string

Il nome del post locale da recuperare.

GetLocationRequest

Messaggio di richiesta per locations.GetLocation.

Campi
name

string

Il nome della posizione da recuperare.

GetMediaItemRequest

Messaggio di richiesta per Media.GetMediaItem.

Campi
name

string

Il nome dell'elemento multimediale richiesto.

GetNotificationsRequest

Richiesta di un messaggio per Accounts.Getnotifications.

Campi
name

string

Il nome della risorsa delle impostazioni di notifica.

GetReviewRequest

Messaggio di richiesta per Reviews.GetReview.

Campi
name

string

Il nome della recensione da recuperare.

GetServiceListRequest

Recupera il messaggio di richiesta dell'elenco dei servizi.

Campi
name

string

Obbligatorio. Identificatore Google di questa sede nel formato: accounts/{account_id}/locations/{location_id}/servicelist

GoogleLocation

Rappresenta un valore Location presente su Google. Può trattarsi di una sede che è stata rivendicata dall'utente o da qualcun altro oppure che potrebbe non essere stata rivendicata.

Campi
name

string

Nome risorsa di questa posizione Google, nel formato googleLocations/{googleLocationId}.

location

Location

Informazioni su Location fornite in modo sparso. Questo campo può essere riutilizzato in CreateLocation se al momento non è rivendicato da un utente.

request_admin_rights_url

string

Un URL che reindirizza l'utente all'interfaccia utente per i diritti di amministratore della richiesta. Questo campo è presente solo se la località è già stata rivendicata da un utente, incluso l'utente corrente.

GoogleUpdatedLocation

Rappresenta una sede modificata da Google.

Campi
location

Location

La versione aggiornata da Google di questa località.

diff_mask

FieldMask

I campi aggiornati da Google.

HealthProviderAttributes

Attributi del fornitore di servizi sanitari collegati a questa sede

Campi
name

string

Obbligatorio. Identificatore Google di questa sede nel formato: accounts/{account_id}/locations/{location_id}/healthProviderAttributes

insurance_networks[]

InsuranceNetwork

(Facoltativo) Un elenco delle reti di assicurazioni attive per questa località.

InsuranceNetwork

Un'unica rete assicurativa. ID successivo: 5

Campi
network_id

string

Obbligatorio. L'ID di questa rete assicurativa generata da Google.

network_names

map<string, string>

Solo output. Una mappa dei nomi visualizzati di rete nelle lingue richieste in cui la lingua è la chiave e il nome visualizzato localizzato è il valore. Il nome visualizzato in inglese è impostato per impostazione predefinita.

payer_names

map<string, string>

Solo output. Una mappa dei nomi visualizzati del pagatore nelle lingue richieste, in cui la lingua è la chiave e il valore visualizzato localizzato è il valore. Il nome visualizzato in inglese è impostato per impostazione predefinita.

state

NetworkState

Solo output. Stato di questa rete assicurativa.

InternalError

Descrive gli errori interni.

Campi
error_details[]

ErrorDetail

Descrive i singoli errori.

Invito

Solo output. Rappresenta un invito in attesa.

Campi
name

string

Il nome della risorsa per l'invito.

role

AdminRole

Ruolo invitato per l'account.

Campo unione target. Indica il target a cui si riferisce questo invito. target può essere solo uno dei seguenti:
target_account

Account

L'account con poche informazioni a cui è destinato questo invito.

target_location

TargetLocation

La località di destinazione a cui è indirizzato l'invito.

TargetLocation

Rappresenta una località di destinazione per un invito in attesa.

Campi
location_name

string

Il nome della sede alla quale l'utente è invitato.

location_address

string

L'indirizzo della sede alla quale l'utente è invitato.

ListAccountAdminsRequest

Messaggio di richiesta per AccessControl.ListAccountAdmins.

Campi
parent

string

Il nome dell'account da cui recuperare un elenco di amministratori.

ListAccountAdminsResponse

Messaggio di risposta per AccessControl.ListAccountAdmins.

Campi
admins[]

Admin

Una raccolta di istanze Admin.

ListAccountsRequest

Messaggio di richiesta per Accounts.ListAccounts.

Campi
page_size

int32

Il numero di account da recuperare per pagina. Il valore predefinito è 20, il minimo è 2 e la dimensione massima della pagina è 20.

page_token

string

Se specificato, viene recuperata la pagina degli account successiva. pageToken viene restituito quando una chiamata a accounts.list restituisce più risultati di quelli che possono rientrare nelle dimensioni di pagina richieste.

name

string

Il nome della risorsa dell'account per il quale deve essere recuperato l'elenco degli account direttamente accessibili. Questo ha senso solo per le organizzazioni e i gruppi di utenti. Se vuoto, restituirà ListAccounts per l'utente autenticato.

filter

string

Un filtro vincola gli account da restituire. La risposta include solo le voci che corrispondono al filtro. Se il campo filter è vuoto, non vengono applicati vincoli e tutti gli account (suddivise in pagine) vengono recuperati per l'account richiesto.

Ad esempio, una richiesta con il filtro type=USER_GROUP restituirà solo gruppi di utenti.

ListAccountsResponse

Messaggio di risposta per Accounts.ListAccounts.

Campi
accounts[]

Account

Una raccolta di account a cui l'utente ha accesso. L'account personale dell'utente che esegue la query sarà sempre il primo elemento del risultato, a meno che non venga filtrato.

next_page_token

string

Se il numero di account supera le dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina di account successiva in una chiamata successiva a accounts.list. Se non sono presenti altri account, questo campo non è presente nella risposta.

ListAnswersRequest

Messaggio di richiesta per questionsAndAnswers.ListAnswers

Campi
parent

string

Il nome della domanda per cui recuperare le risposte.

page_size

int32

Il numero di risposte da recuperare per pagina. I valori predefiniti e massimi di page_size sono 10.

page_token

string

Se specificata, viene recuperata la pagina successiva di risposte.

order_by

string

L'ordine per restituire le risposte. Le opzioni valide includono "update_time desc" e "upvote_count desc", che restituirà le risposte in ordine decrescente in base al campo richiesto. L'ordinamento predefinito è "update_time desc".

ListAnswersResponse

Messaggio di risposta per questionsAndAnswers.ListAnswers

Campi
answers[]

Answer

Le risposte richieste.

total_size

int32

Il numero totale di risposte pubblicate per questa domanda in tutte le pagine.

next_page_token

string

Se il numero di risposte supera la dimensione massima della pagina richiesta, questo campo viene compilato con un token per recuperare la pagina successiva di risposte in una chiamata successiva. Se non sono presenti altre risposte, questo campo non è presente nella risposta.

ListAttributeMetadataRequest

Messaggio di richiesta per locations.ListAttributeMetadata. Se viene fornito il nome della risorsa località, questa verrà utilizzata per compilare il resto dei criteri. Se non è presente, è necessario specificare la categoria e il paese.

Campi
name

string

Nome della risorsa della località per cercare gli attributi disponibili.

category_id

string

L'ID stabile della categoria principale per trovare gli attributi disponibili.

country

string

Il codice paese ISO 3166-1 alpha-2 per trovare gli attributi disponibili.

language_code

string

Il codice della lingua BCP 47 in cui inserire i nomi visualizzati degli attributi. Se questa lingua non è disponibile, verranno fornite in inglese.

page_size

int32

Il numero di attributi da includere per pagina. Il valore predefinito è 200, il minimo è 1.

page_token

string

Se specificato, viene recuperata la pagina successiva dei metadati degli attributi. pageToken viene restituito quando una chiamata a attributes.list restituisce più risultati di quelli che possono rientrare nelle dimensioni di pagina richieste.

ListAttributeMetadataResponse

Messaggio di risposta per locations.ListAttributeMetadata.

Campi
attributes[]

AttributeMetadata

Una raccolta di metadati degli attributi per gli attributi disponibili.

next_page_token

string

Se il numero di attributi supera le dimensioni di pagina richieste, questo campo verrà compilato con un token per recuperare la pagina successiva di attributi in una chiamata successiva a attributes.list. Se non sono presenti altri attributi, questo campo non sarà presente nella risposta.

ListBusinessCategoriesRequest

Campi
region_code

string

Il codice paese ISO 3166-1 alpha-2.

language_code

string

Il codice del linguaggio BCP 47. Se la lingua non è disponibile, verrà utilizzata per impostazione predefinita l'inglese.

search_term

string

Stringa di filtro facoltativa dell'utente.

page_size

int32

Quante categorie recuperare per pagina. Il valore predefinito è 100, il minimo è 1 e la dimensione massima della pagina è 100.

page_token

string

Se specificato, verrà recuperata la pagina successiva di categorie.

view

CategoryView

(Facoltativo) Specifica le parti della risorsa Categoria da restituire nella risposta.

ListBusinessCategoriesResponse

Campi
categories[]

Category

Le categorie. Le categorie sono visualizzazione DI BASE. Non contengono informazioni ServiceType.

total_category_count

int32

Il numero totale di categorie per i parametri della richiesta.

next_page_token

string

Se il numero di categorie ha superato le dimensioni di pagina richieste, questo campo verrà compilato con un token per recuperare la pagina successiva di categorie in una chiamata successiva a ListBusinessCategories.

ListCustomerMediaItemsRequest

Messaggio di richiesta per Media.ListCustomerMediaItems.

Campi
parent

string

Il nome della sede di cui verranno elencati gli elementi multimediali del cliente.

page_size

int32

Il numero di elementi multimediali da restituire per pagina. Il valore predefinito è 100, mentre la dimensione massima supportata per la pagina è 200.

page_token

string

Se specificato, restituisce la pagina successiva di elementi multimediali.

ListCustomerMediaItemsResponse

Messaggio di risposta per Media.ListCustomerMediaItems.

Campi
media_items[]

MediaItem

L'elenco di elementi multimediali restituito.

total_media_item_count

int32

Il numero totale di elementi multimediali per questa posizione, indipendentemente dall'impaginazione. Questo valore è approssimativo, in particolare in presenza di più pagine di risultati.

next_page_token

string

Se sono presenti più elementi multimediali rispetto alle dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di elementi multimediali in una chiamata successiva a ListCustomerMediaItems.

ListInsuranceNetworksRequest

Messaggio di richiesta per InsuranceNetworkService.ListInsuranceNetworks

Campi
parent

string

Obbligatorio. Il nome della località di cui verranno elencate le reti assicurative. Il nome è nel formato: accounts/{account_id}/locations/{location_id}

language_code

string

(Facoltativo) Il codice BCP 47 per la lingua. Se non viene fornito un codice lingua, per impostazione predefinita viene utilizzato l'inglese. Per ora solo "en" è supportato.

page_size

int32

Numero di reti di assicurazioni da restituire per pagina. Il valore predefinito è 5000. La dimensione massima della pagina è 10.000.

page_token

string

Se specificata, restituisce la pagina successiva delle reti di assicurazioni.

ListInsuranceNetworksResponse

Messaggio di risposta per InsuranceNetworkService.ListInsuranceNetworks

Campi
networks[]

InsuranceNetwork

Un elenco di reti di assicurazioni supportate da Google.

next_page_token

string

Se esistono più reti di assicurazioni rispetto alle dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva delle reti assicurative in una chiamata successiva a ListInsuranceNetworks.

ListInvitationsRequest

Messaggio di richiesta per AccessControl.ListInvitations.

Campi
parent

string

Il nome dell'account da cui viene recuperato l'elenco degli inviti.

target_type

TargetType

Specifica i tipi di target che devono essere visualizzati nella risposta.

TargetType

Il tipo di target a cui è rivolto un invito.

Enum
ALL Elenca gli inviti per tutti i tipi di target. Questa è l'impostazione predefinita.
ACCOUNTS_ONLY Elenca gli inviti solo per i target di tipo Account.
LOCATIONS_ONLY Elenca gli inviti solo per i target di tipo Località.

ListInvitationsResponse

Messaggio di risposta per AccessControl.ListInvites.

Campi
invitations[]

Invitation

Una raccolta di inviti alla posizione in attesa per l'account. Il numero di inviti qui elencato non può essere superiore a 1000.

ListLocalPostsRequest

Messaggio di richiesta per ListLocalPosts

Campi
parent

string

Il nome della sede di cui verranno elencati i post locali.

page_size

int32

Il numero di post locali da restituire per pagina. Il valore predefinito è 20. Il valore minimo è 1, mentre quello massimo è 100.

page_token

string

Se specificato, restituisce la pagina successiva di post locali.

ListLocalPostsResponse

Messaggio di risposta per ListLocalPosts

Campi
local_posts[]

LocalPost

L'elenco di post locali restituito.

next_page_token

string

Se sono presenti più post locali rispetto alle dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di post locali in una chiamata successiva a ListLocalPosts.

ListLocationAdminsRequest

Messaggio di richiesta per AccessControl.ListLocationAdmins.

Campi
parent

string

Il nome della sede di cui elencare gli amministratori.

ListLocationAdminsResponse

Messaggio di risposta per AccessControl.ListLocationAdmins.

Campi
admins[]

Admin

Una raccolta di istanze Admin.

ListLocationsRequest

Messaggio di richiesta per locations.ListLocations.

Campi
parent

string

Il nome dell'account da cui recuperare le posizioni. Se l'Account è di AccountType PERSONALE, vengono restituite solo le Sedi che sono di proprietà diretta dell'Account, altrimenti verranno restituite tutte le sedi accessibili dall'Account, direttamente o indirettamente.

page_size

int32

Il numero di sedi da recuperare per pagina. Il valore predefinito è 100, il minimo è 1 e la dimensione massima della pagina è 100.

page_token

string

Se specificato, consente di recuperare le page posizioni successive. Il token di pagina viene restituito dalle chiamate precedenti a ListLocations quando sono presenti più sedi di quelle che potrebbero rientrare nelle dimensioni di pagina richieste.

filter

string

Un filtro vincola le località da restituire. La risposta include solo le voci che corrispondono al filtro. Se il campo filter è vuoto, vengono applicati i vincoli e vengono recuperate tutte le località (suddivise in pagine) per l'account richiesto.

Per ulteriori informazioni sui campi validi e sull'utilizzo di esempio, consulta la Guida all'utilizzo dei dati sulla posizione.

language_code
(deprecated)

string

Il codice della lingua BCP 47 in cui visualizzare le proprietà della località. Se questa lingua non è disponibile, verranno forniti nella lingua della località. Se nessuno dei due è disponibile, verrà fornito in inglese.

Deprecato. Dopo il 15 agosto 2020, questo campo non verrà più applicato. Verrà invece sempre utilizzata la lingua della località.

order_by

string

Ordinamento della richiesta. Più campi devono essere separati da virgole, secondo la sintassi SQL. L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente, un suffisso " disc" aggiungere. I campi validi per order_by sono location_name e store_code. Ad esempio: "location_name, store_code desc". o "location_name" o "store_code desc"

ListLocationsResponse

Messaggio di risposta per locations.ListLocations.

Campi
locations[]

Location

Le località.

next_page_token

string

Se il numero di sedi supera le dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di sedi in una chiamata successiva a ListLocations. Se non sono presenti altre località, questo campo non è presente nella risposta.

total_size

int32

Il numero approssimativo di località nell'elenco, indipendentemente dall'impaginazione.

ListMediaItemsRequest

Messaggio di richiesta per Media.ListMediaItems.

Campi
parent

string

Il nome della posizione di cui verranno elencati gli elementi multimediali.

page_size

int32

Il numero di elementi multimediali da restituire per pagina. Il valore predefinito è 100, ovvero il numero massimo supportato di elementi multimediali che è possibile aggiungere a una sede con l'API Google My Business. La dimensione massima della pagina è 2500.

page_token

string

Se specificato, restituisce la pagina successiva di elementi multimediali.

ListMediaItemsResponse

Messaggio di risposta per Media.ListMediaItems.

Campi
media_items[]

MediaItem

L'elenco di elementi multimediali restituito.

total_media_item_count

int32

Il numero totale di elementi multimediali per questa posizione, indipendentemente dall'impaginazione.

next_page_token

string

Se sono presenti più elementi multimediali rispetto alle dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di elementi multimediali in una chiamata successiva a ListMediaItems.

ListQuestionsRequest

Messaggio di richiesta per questionsAndAnswers.ListQuestions

Campi
parent

string

Il nome del luogo per cui recuperare le domande.

page_size

int32

Numero di domande da recuperare per pagina. I valori predefiniti e massimi di page_size sono 10.

page_token

string

Se specificata, viene recuperata la pagina successiva di domande.

answers_per_question

int32

Quante risposte recuperare per domanda. I valori predefiniti e massimi di answers_per_question sono 10.

filter

string

Un filtro vincola le domande da restituire. L'unico filtro attualmente supportato è "ignore_answered=true"

order_by

string

L'ordine per restituire le domande. Le opzioni valide includono "update_time desc" e "upvote_count desc", che restituirà le domande in ordine decrescente in base al campo richiesto. L'ordinamento predefinito è "update_time desc".

ListQuestionsResponse

Messaggio di risposta per questionsAndAnswers.ListQuestions

Campi
questions[]

Question

Le domande richieste,

total_size

int32

Il numero totale di domande pubblicate per questa località in tutte le pagine.

next_page_token

string

Se il numero di domande supera la dimensione massima della pagina richiesta, questo campo viene compilato con un token per recuperare la pagina successiva di domande in una chiamata successiva. Se non ci sono altre domande, questo campo non è presente nella risposta.

ListRecommendedGoogleLocationsRequest

Richiedi un messaggio che indichi le località consigliate per un account Profilo dell'attività.

Campi
name

string

Nome della risorsa dell'account per cui recuperare le località Google consigliate.

page_size

int32

Il numero di sedi da recuperare per pagina. Il valore predefinito è 25, il minimo è 1 e la dimensione massima della pagina è 100.

page_token

string

Se specificata, viene recuperata la pagina successiva delle sedi.

ListRecommendedGoogleLocationsResponse

Messaggio di risposta relativo a GoogleLocations.ListrecommendedGoogleLocations.

Contiene anche alcune sedi che sono state rivendicate da altri utenti di Profilo dell'attività dall'ultima volta che sono state consigliate per questo account Profilo dell'attività.

Campi
google_locations[]

GoogleLocation

Le località consigliate per un account Profilo dell'attività. Ciascuno di questi rappresenta un GoogleLocation presente su Maps. Le sedi sono ordinate in ordine decrescente di pertinenza per l'account Profilo dell'attività.

total_size

int32

Il numero totale di sedi consigliate per questo account Profilo dell'attività, indipendentemente dall'impaginazione.

next_page_token

string

Durante l'impaginazione, se nella pagina successiva sono disponibili più sedi da recuperare, questo campo viene compilato con un token per recuperare la pagina di sedi successiva in una chiamata successiva. Se non sono presenti altre località da recuperare, questo campo non è presente nella risposta.

ListReviewsRequest

Messaggio di richiesta per Reviews.ListReviews.

Campi
parent

string

Il nome della sede per cui recuperare le recensioni.

page_size

int32

Numero di recensioni da recuperare per pagina. Il numero massimo di page_size è 50.

page_token

string

Se specificato, consente di recuperare la pagina successiva di recensioni.

order_by

string

Specifica il campo in base al quale ordinare le recensioni. Se non viene specificato, l'ordine delle recensioni restituite verrà impostato sul valore predefinito update_time desc. Gli ordini validi per l'ordinamento sono rating, rating desc e update_time desc.

ListReviewsResponse

Messaggio di risposta per Reviews.ListReviews.

Campi
reviews[]

Review

Le recensioni.

average_rating

double

La valutazione a stelle media di tutte le recensioni per questa località su una scala da 1 a 5, dove 5 è la valutazione più alta.

total_review_count

int32

Il numero totale di recensioni per questa località.

next_page_token

string

Se il numero di recensioni supera le dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di recensioni in una chiamata successiva a ListReviews. Se non ci sono altre recensioni, questo campo non è presente nella risposta.

ListVerificationsRequest

Messaggio di richiesta per Verifications.ListVerifications.

Campi
parent

string

Nome risorsa della località a cui appartengono le richieste di verifica.

page_size

int32

Numero di verifiche da includere per pagina. Se non viene impostato, restituisce tutto.

page_token

string

Se specificato, restituisce la pagina successiva di verifiche.

ListVerificationsResponse

Messaggio di risposta relativo a Verifications.ListVerifications.

Campi
verifications[]

Verification

Elenco delle verifiche.

next_page_token

string

Se il numero di verifiche ha superato le dimensioni di pagina richieste, questo campo verrà compilato con un token per recuperare la pagina di verifica successiva in una chiamata successiva. Se non sono presenti altri attributi, questo campo non sarà presente nella risposta.

LocalPost

Rappresenta un post locale di una sede.

Campi
name

string

Solo output. Identificatore Google per questo post locale nel modulo: accounts/{account_id}/locations/{location_id}/localPosts/{local_post_id}

language_code

string

La lingua del post locale.

summary

string

Descrizione/corpo del post locale.

call_to_action

CallToAction

L'URL a cui vengono indirizzati gli utenti quando fanno clic sulla promozione. Ignorato per il tipo di argomento OFFER.

create_time

Timestamp

Solo output. Ora di creazione del post.

update_time

Timestamp

Solo output. L'ora dell'ultima modifica del post effettuata dall'utente.

event

LocalPostEvent

Informazioni sull'evento. Obbligatorio per i tipi di argomento EVENT e OFFER.

state

LocalPostState

Solo output. Lo stato del post, che indica in quale parte del suo ciclo di vita si trova.

media[]

MediaItem

I contenuti multimediali associati al post. source_url è l'unico campo di dati supportato per un LocalPost MediaItem.

search_url

string

Solo output. Il link al post locale nella Ricerca Google. Questo link può essere utilizzato per condividere il post tramite social media, email, SMS e così via.

topic_type

LocalPostTopicType

Obbligatorio. Il tipo di argomento del post: standard, evento, offerta o avviso.

alert_type

AlertType

Il tipo di avviso per cui è stato creato il post. Questo campo si applica solo ai post di topic_type Alert e si comporta come un sottotipo di Alert.

offer

LocalPostOffer

Dati aggiuntivi per i post sulle offerte. Deve essere impostato solo se l'argomento topic_type è OFFER.

LocalPostState

Indica lo stato del post

Enum
LOCAL_POST_STATE_UNSPECIFIED Stato non specificato.
REJECTED Questo post è stato rifiutato a causa di una violazione delle norme relative ai contenuti.
LIVE Questo post è stato pubblicato ed è attualmente visualizzato nei risultati di ricerca.
PROCESSING Questo post è in fase di elaborazione e non viene visualizzato nei risultati di ricerca.

LocalPostEvent

Tutte le informazioni relative a un evento presenti in un post locale.

Campi
title

string

Nome dell'evento.

schedule

TimeInterval

Data/ora di inizio e di fine dell'evento.

LocalPostMetrics

Tutte le metriche richieste per un post locale.

Campi
local_post_name

string

metric_values[]

MetricValue

Un elenco di valori per le metriche richieste.

LocalPostOffer

Campi specifici per i post sulle offerte.

Campi
coupon_code

string

(Facoltativo) Codice offerta utilizzabile in negozio o online.

redeem_online_url

string

(Facoltativo) Link online per utilizzare l'offerta.

terms_conditions

string

(Facoltativo) Termini e condizioni dell'offerta.

LocalPostTopicType

Il tipo di argomento del post locale, utilizzato per selezionare diversi modelli per creare e visualizzare un post.

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Nessun tipo di post specificato.
STANDARD Il post contiene informazioni di base, come riepilogo e immagini.
EVENT Il post contiene informazioni di base e un evento.
OFFER Il post contiene informazioni di base, un evento e contenuti correlati all'offerta (ad es. codice coupon)
ALERT Annunci tempestivi e ad alta priorità relativi a un evento in corso. Questi tipi di post non sono sempre disponibili per la creazione.

Località

Una località. Consulta l'articolo del Centro assistenza per una descrizione dettagliata di questi campi oppure l'endpoint di categoria per un elenco di categorie aziendali valide.

Campi
name

string

Identificatore Google di questa sede nel formato: accounts/{account_id}/locations/{location_id}

Questo campo non verrà compilato.

language_code

string

La lingua del luogo. Impostato durante la creazione e non aggiornabile.

store_code

string

Identificatore esterno per questa località, che deve essere univoco all'interno di un determinato account. Consente di associare la sede ai tuoi record.

location_name

string

Il nome della sede deve rispecchiare il nome reale della tua attività, utilizzato in modo coerente sul negozio fisico, sul sito web e sulla cancelleria e come noto ai clienti. Eventuali informazioni aggiuntive, se pertinenti, possono essere incluse in altri campi della risorsa (ad esempio Address, Categories). Non aggiungere al nome informazioni non necessarie (ad esempio, preferisci "Google" a "Google Inc. - Sede centrale dell'azienda Mountain View"). Non includere slogan di marketing, codici negozio, caratteri speciali, orari o stato di chiusura/apertura, numeri di telefono, URL di siti web, informazioni su servizi/prodotti, posizione/indirizzo o indicazioni stradali oppure informazioni sul contenimento (ad es. "Bancomat Chase in Duane Reade").

primary_phone

string

Un numero di telefono che consenta di contattare nel modo più diretto possibile la sede dell'attività commerciale. Se possibile, utilizza un numero di telefono locale, anziché quello di un call center.

additional_phones[]

string

Fino a due numeri di telefono (di cellulare o fisso, non di fax) ai quali è possibile chiamare la tua attività, oltre al numero di telefono principale.

address

PostalAddress

Un indirizzo preciso e preciso per descrivere la sede della tua attività. Caselle postali o cassette postali situate in località remote non sono ammesse. Al momento, puoi specificare un massimo di cinque valori address_lines nell'indirizzo.

primary_category

Category

Categoria che descrive meglio l'attività principale in cui opera questa sede.

additional_categories[]

Category

Categorie aggiuntive per descrivere la tua attività. Le categorie consentono ai clienti di trovare risultati accurati e specifici per i servizi di loro interesse. Per fare in modo che le informazioni sulla tua attività siano sempre accurate e pubblicate, assicurati di utilizzare il minor numero possibile di categorie per descrivere la tua attività principale nel suo complesso. Scegli le categorie più specifiche possibile, ma rappresentative della tua attività principale.

website_url

string

Un URL per questa attività. Se possibile, utilizza un URL che rappresenti la singola sede dell'attività commerciale anziché un sito web/URL generico che rappresenta tutte le sedi o il brand.

regular_hours

BusinessHours

Orario di apertura dell'attività.

special_hours

SpecialHours

Orari speciali per l'attività. Ciò include in genere l'orario festivo e altri orari al di fuori del normale orario di apertura. Queste modifiche sostituiscono il normale orario di apertura.

service_area

ServiceAreaBusiness

Le attività al domicilio del cliente forniscono il proprio servizio presso la sede del cliente. Se questa attività è un'attività al domicilio del cliente, questo campo descrive l'area o le aree servite dall'attività.

location_key

LocationKey

Una raccolta di chiavi che collega questa attività ad altre proprietà di Google, come una pagina Google+ e Google Maps Places.

labels[]

string

Una raccolta di stringhe in formato libero che ti consente di taggare la tua attività. Queste etichette NON sono rivolte agli utenti; solo tu puoi vederle. Massimo 255 caratteri (per etichetta).

ad_words_location_extensions

AdWordsLocationExtensions

Informazioni aggiuntive visualizzate in AdWords.

latlng

LatLng

Latitudine e longitudine fornite dall'utente. Quando crei una località, questo campo viene ignorato se l'indirizzo fornito codifica correttamente la posizione geografica. Questo campo viene restituito nelle richieste get solo se il valore latlng fornito dall'utente è stato accettato durante la creazione o se il valore latlng è stato aggiornato tramite il sito web di Profilo dell'attività. Questo campo non può essere aggiornato.

open_info

OpenInfo

Un flag che indica se la sede è attualmente aperta.

location_state

LocationState

Solo output. Un insieme di valori booleani che riflette lo stato di una località.

attributes[]

Attribute

Attributi per questa località.

metadata

Metadata

Solo output. Informazioni aggiuntive non modificabili dall'utente.

price_lists[]
(deprecated)

PriceList

Obsoleto: informazioni sul listino prezzi per questa località.

profile

Profile

Descrive la tua attività con il tuo stile e condivide con gli utenti la storia unica della tua attività e delle tue offerte.

relationship_data

RelationshipData

Tutte le sedi e le catene correlate a questa.

more_hours[]

MoreHours

Altri orari per i diversi reparti o per clienti specifici di un'attività.

Metadati

Ulteriori informazioni sulla località non modificabili dall'utente.

Campi
duplicate
(deprecated)

Duplicate

Informazioni sulla sede duplicata da questa sede. Presente solo quando location_state.is_duplicate è true. Obsoleta: le informazioni dettagliate per i duplicati non sono più supportate.

maps_url

string

Un link alla posizione su Maps.

new_review_url

string

Un link alla pagina nella Ricerca Google in cui un cliente può lasciare una recensione per la sede.

Duplica

Informazioni sulla sede duplicata da questa sede.

Campi
location_name

string

Il nome della risorsa della località duplicata. Compilato solo se l'utente autenticato dispone dei diritti di accesso a quella località e questa non viene eliminata.

place_id

string

L'ID della località duplicata.

access

Access

Indica se l'utente ha accesso alla posizione in cui viene duplicato.

Accesso

Il livello di accesso dell'utente alla località duplicata. Sostituisci Proprietà e deve essere utilizzata.

Enum
ACCESS_UNSPECIFIED Non specificato.
ACCESS_UNKNOWN Impossibile determinare se l'utente ha accesso alla posizione che duplica.
ALLOWED L'utente ha accesso alla posizione che duplica.
INSUFFICIENT L'utente non ha accesso alla posizione che duplica.

RelationshipData

Informazioni di tutte le sedi dei publisher principali e secondari correlate a questa.

Campi
parent_chain

string

Il nome della risorsa della catena di cui fa parte questa località. How to find Chain ID

LocationDrivingDirectionMetrics

Una località indicizzata con le regioni da cui provengono solitamente le persone. Questo valore viene acquisito conteggiando il numero di richieste di indicazioni stradali verso questa località provenienti da ogni regione.

Campi
location_name

string

Il nome della risorsa località a cui appartiene questo valore della metrica.

top_direction_sources[]

TopDirectionSources

Richieste di indicazioni stradali per regione di origine. Per convenzione, queste informazioni sono ordinate in base al conteggio, con al massimo 10 risultati.

time_zone

string

Fuso orario (ID fuso orario IANA, ad esempio "Europa/Londra") della località.

TopDirectionSources

Regioni principali da cui provengono le richieste di indicazioni stradali.

Campi
day_count

int32

I dati relativi al numero di giorni vengono aggregati.

region_counts[]

RegionCount

Regioni ordinate in ordine decrescente per conteggio.

RegionCount

Una regione con il numero di richieste associato.

Campi
latlng

LatLng

Centro della regione.

label

string

Etichetta leggibile per la regione.

count

int64

Numero di richieste di indicazioni stradali da questa regione.

LocationKey

Riferimenti chiave alternativi/surrogati per una località.

Campi
plus_page_id

string

Solo output. Se alla sede è associata una pagina Google+, viene inserito l'ID della pagina Google+ della sede in questione.

place_id

string

Se questa sede è stata verificata ed è collegata o visualizzata su Google Maps, questo campo viene compilato con l'ID luogo della sede. Questo ID può essere utilizzato in varie API Places.

Se questa sede non è verificata, questo campo potrebbe essere compilato se la sede è stata associata a un luogo visualizzato su Google Maps.

Questo campo può essere impostato durante le chiamate Crea, ma non per Update.

Il bool explicit_no_place_id aggiuntivo è idoneo indipendentemente dal fatto che un ID luogo non impostato sia intenzionale o meno.

explicit_no_place_id

bool

Solo output. Il valore true indica che l'ID luogo non impostato è intenzionale, diversamente da quando non è stata ancora effettuata alcuna associazione.

request_id

string

Solo output. request_id utilizzato per creare questa sede. Il campo potrebbe essere vuoto se questa sede è stata creata al di fuori dell'API Google My Business o delle sedi in Profilo dell'attività.

LocationMetrics

Una serie di metriche e metriche di distribuzione associate a una località in un determinato intervallo di tempo.

Campi
location_name

string

Il nome della risorsa località a cui appartengono questi valori.

time_zone

string

Fuso orario IANA per la località.

metric_values[]

MetricValue

Un elenco di valori per le metriche richieste.

LocationReview

Rappresenta una recensione con informazioni sulla posizione.

Campi
name

string

Nome risorsa posizione.

review

Review

Una recensione per il luogo.

LocationState

Contiene un insieme di valori booleani che riflettono lo stato di una località.

Campi
is_google_updated

bool

Solo output. Indica se l'ID luogo associato a questa località è aggiornato.

is_duplicate

bool

Solo output. Indica se la sede è un duplicato di un'altra.

is_suspended

bool

Solo output. Indica se la sede è sospesa. Le sedi sospese non sono visibili agli utenti finali nei prodotti Google. Se ritieni che si sia trattato di un errore, consulta l'articolo del Centro assistenza.

can_update

bool

Solo output. Indica se la posizione può essere aggiornata.

can_delete

bool

Solo output. Indica se la sede può essere eliminata utilizzando l'API Google My Business.

is_verified

bool

Solo output. Indica se la sede è verificata.

needs_reverification

bool

Solo output. Indica se la sede richiede una nuova verifica.

is_pending_review

bool

Solo output. Indica se la revisione della sede è in attesa.

is_disabled

bool

Solo output. Indica se la posizione è disattivata.

is_published

bool

Solo output. Indica se la località è pubblicata.

is_disconnected

bool

Solo output. Indica se la sede è scollegata da un luogo su Google Maps.

is_local_post_api_disabled

bool

Solo output. Indica se accounts.locations.localPosts è disattivato per questa sede.

can_modify_service_list

bool

Solo output. Indica se l'elenco può modificare un ServiceList.

can_have_food_menus

bool

Solo output. Indica se la scheda è idonea per il menù del cibo.

has_pending_edits

bool

Solo output. Indica se una delle proprietà di questa località è in stato di modifica in attesa.

has_pending_verification

bool

Solo output. Indica se la sede ha richieste di verifica in attesa.

can_operate_health_data

bool

Solo output. Indica se la località può operare su dati sanitari.

can_operate_lodging_data

bool

Solo output. Indica se la località può utilizzare i dati delle strutture ricettive.

MatchedLocation

Rappresenta una possibile corrispondenza con una località.

Campi
location

Location

La località con pochi dati che rappresenta una potenziale corrispondenza. I campi non compilati includono, a titolo esemplificativo: nome (la località corrispondente non può essere recuperata tramite GetLocation o BatchGetLocations); store_code; Dettagli sull'area di copertura: service_area; labels; ad_words_location_extensions; photos

is_exact_match

bool

Si tratta di una corrispondenza esatta?

MediaItem

Un singolo elemento multimediale.

Campi
name

string

Il nome della risorsa per questo elemento multimediale. accounts/{account_id}/locations/{location_id}/media/{media_key}

media_format

MediaFormat

Il formato di questo elemento multimediale. Deve essere impostata al momento della creazione dell'elemento multimediale ed è di sola lettura in tutte le altre richieste. Impossibile aggiornare.

location_association

LocationAssociation

Obbligatorio quando chiami CreatePhoto. Descrive come questo elemento multimediale è collegato alla sua posizione. Deve essere una categoria (ad es. EXTERIOR) o l'ID di un articolo di listino.

Questa operazione è necessaria quando si aggiungono nuovi contenuti multimediali a una località con CreateMediaItem. Per altri tipi di contenuti multimediali, ad esempio le foto nei post locali, non sarà presente.

google_url

string

Solo output. URL ospitato da Google per questo elemento multimediale. Questo URL non è statico poiché potrebbe cambiare nel tempo. Per i video sarà un'immagine di anteprima con un'icona di riproduzione sovrapposta.

thumbnail_url

string

Solo output. Se fornito, l'URL di un'immagine in miniatura per questo elemento multimediale.

create_time

Timestamp

Solo output. Ora di creazione di questo elemento multimediale.

dimensions

Dimensions

Solo output. Le dimensioni (larghezza e altezza) in pixel.

insights

MediaInsights

Solo output. Statistiche per questo elemento multimediale.

attribution

Attribution

Solo output. Informazioni sull'attribuzione per gli elementi multimediali del cliente. Devi mostrare questa attribuzione come fornita agli utenti e non devi eliminarla o alterare.

description

string

Descrizione di questo elemento multimediale. Le descrizioni non possono essere modificate tramite l'API Google My Business, ma possono essere impostate quando si crea un nuovo elemento multimediale che non sia una foto di copertina.

Campo unione data. L'origine dati dell'elemento multimediale. Quando crei un nuovo elemento multimediale, devi fornire un URL o un riferimento dati.

Ad eccezione delle categorie PROFILE e COVER, tutte le foto devono avere dimensioni minime pari a 250 px sul lato corto e dimensioni file di almeno 10240 byte.

Tutte le foto caricate devono rispettare le linee guida di Profilo dell'attività per le foto. data può essere solo uno dei seguenti:

source_url

string

Un URL accessibile pubblicamente da cui è possibile recuperare l'elemento multimediale.

Quando viene creato, è necessario impostare data_ref per specificare l'origine dell'elemento multimediale.

Se source_url è stato utilizzato durante la creazione di un elemento multimediale, verrà compilato con l'URL di origine quando viene recuperato l'elemento multimediale.

Questo campo non può essere aggiornato.

data_ref

MediaItemDataRef

Solo input. Un riferimento ai dati binari degli elementi multimediali ottenuti con il metodo StartUploadMediaItemData.

Quando crei un elemento multimediale,

sourceUrl

o

dataRef

è necessario impostare.

Attribuzione

Informazioni sull'attribuzione per gli elementi multimediali del cliente, ad esempio il nome e l'immagine del profilo del collaboratore.

Campi
profile_name

string

Il nome utente a cui attribuire l'elemento multimediale.

profile_photo_url

string

URL della miniatura della foto del profilo dell'utente attribuito.

takedown_url

string

L'URL della pagina di rimozione, in cui l'elemento multimediale può essere segnalato se non è appropriato.

profile_url

string

L'URL della pagina del profilo Google Maps dell'utente attribuito.

Dimensioni

Dimensioni dell'elemento multimediale.

Campi
width_pixels

int32

Larghezza dell'elemento multimediale, in pixel.

height_pixels

int32

Altezza dell'elemento multimediale, in pixel.

LocationAssociation

Il modo in cui l'elemento multimediale viene associato alla sua posizione.

Campi
Campo unione location_attachment_type. I contenuti multimediali della posizione devono avere una categoria o l'ID di un articolo di listino a cui sono associati. Gli elementi multimediali diversi dalla posizione (ad esempio le foto dei post locali) non devono contenere nessuno dei due elementi. location_attachment_type può essere solo uno dei seguenti:
category

Category

La categoria a cui appartiene questa foto del luogo.

price_list_item_id

string

L'ID di un elemento del listino prezzi a cui è associata questa foto del luogo.

Categoria

Enum per la categoria di elementi multimediali.

Enum
CATEGORY_UNSPECIFIED Categoria non specificata.
COVER Foto di copertina. Una sede ha una sola foto di copertina.
PROFILE Foto del profilo. Una sede ha una sola foto del profilo.
EXTERIOR Media esterni.
INTERIOR Elementi multimediali interni.
PRODUCT Contenuti multimediali del prodotto.
AT_WORK 'In ufficio' contenuti multimediali.
FOOD_AND_DRINK Contenuti multimediali relativi a cibi e bevande.
MENU Contenuti multimediali del menu.
COMMON_AREA Contenuti multimediali delle aree comuni.
ROOMS Contenuti multimediali delle stanze.
TEAMS I contenuti multimediali dei team.
ADDITIONAL Altri contenuti multimediali non classificati.

MediaFormat

Enum per il formato multimediale.

Enum
MEDIA_FORMAT_UNSPECIFIED Formato non specificato.
PHOTO L'elemento multimediale è una foto. In questa versione sono supportate solo le foto.
VIDEO L'elemento multimediale è un video.

MediaInsights

Approfondimenti e statistiche per l'elemento multimediale.

Campi
view_count

int64

Solo output. Il numero di volte in cui l'elemento multimediale è stato visualizzato.

MediaItemDataRef

Riferimento ai dati foto binari di un file MediaItem caricato tramite l'API Google My Business.

Crea un riferimento dati utilizzando StartUploadMediaItemData e usalo per caricare byte su [UpdateMedia] e chiamare successivamente CreateMediaItem.

Campi
resource_name

string

L'ID univoco dei dati binari di questo elemento multimediale. Utilizzato per caricare i dati della foto con [UpdateMedia] e durante la creazione di un nuovo elemento multimediale da quei byte con CreateMediaItem.

Esempio di caricamento di byte: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resource_name}?upload_type=media"

Per le chiamate CreateMediaItem, imposta il valore data_ref di MediaItem.

Etichetta da utilizzare per la visualizzazione del menu e dei suoi vari sottocomponenti.

Campi
display_name

string

Obbligatorio. Nome visualizzato del componente.

description

string

(Facoltativo) Informazioni supplementari sul componente.

language_code

string

(Facoltativo) Il codice del linguaggio BCP 47. Se la lingua non è disponibile, verrà utilizzata per impostazione predefinita l'inglese.

Metrica

Una metrica di dati relativi a una risorsa.

Enum
METRIC_UNSPECIFIED Nessuna metrica specificata.
ALL Sintesi per richiedere tutte le metriche disponibili. Le metriche incluse in ALL variano e dipendono dalla risorsa per cui gli insight vengono richiesti.
QUERIES_DIRECT Il numero di volte in cui la risorsa è stata visualizzata durante la ricerca diretta della località.
QUERIES_INDIRECT Il numero di volte in cui la risorsa è stata mostrata in seguito a una ricerca categorica (ad esempio ristorante).
QUERIES_CHAIN Numero di volte in cui una risorsa è stata mostrata in seguito alla ricerca della catena a cui appartiene o del brand che vende. ad esempio Starbucks, Adidas. Questo è un sottoinsieme di QUERIES_DIRECT.
VIEWS_MAPS Il numero di volte in cui la risorsa è stata visualizzata su Google Maps.
ACTIONS_WEBSITE Il numero di volte in cui è stato fatto clic sul sito web.
ACTIONS_PHONE Numero di volte in cui è stato fatto clic sul numero di telefono.
ACTIONS_DRIVING_DIRECTIONS Il numero di volte in cui sono state richieste le indicazioni stradali in auto.
PHOTOS_VIEWS_MERCHANT Il numero di visualizzazioni degli articoli multimediali caricati dal commerciante.
PHOTOS_VIEWS_CUSTOMERS Il numero di visualizzazioni degli elementi multimediali caricati dai clienti.
PHOTOS_COUNT_MERCHANT Il numero totale di elementi multimediali attualmente pubblicati e caricati dal commerciante.
PHOTOS_COUNT_CUSTOMERS Il numero totale di elementi multimediali attualmente pubblicati e caricati dai clienti.
LOCAL_POST_VIEWS_SEARCH Il numero di volte in cui il post locale è stato visualizzato nella Ricerca Google.
LOCAL_POST_ACTIONS_CALL_TO_ACTION Il numero di volte in cui è stato fatto clic sul pulsante di invito all'azione su Google.

MetricOption

Opzione per specificare come devono essere visualizzati i dati nella risposta.

Enum
METRIC_OPTION_UNSPECIFIED Nessuna opzione di metrica specificata. In una richiesta verrà usato il valore predefinito di AGGREGATED_TOTAL.
AGGREGATED_TOTAL Restituisci i valori aggregati nell'intero periodo di tempo. Questo è il valore predefinito.
AGGREGATED_DAILY Restituisci valori giornalieri con timestamp per tutto l'intervallo di tempo.
BREAKDOWN_DAY_OF_WEEK I valori verranno restituiti come suddivisione per giorno della settimana. Valido solo per ACTIONS_PHONE.
BREAKDOWN_HOUR_OF_DAY I valori verranno restituiti come suddivisione per ora del giorno. Valido solo per ACTIONS_PHONE.

MetricRequest

Una richiesta per restituire valori per una metrica e le opzioni per la restituzione di questi valori.

Campi
metric

Metric

La metrica richiesta.

options[]

MetricOption

Come devono apparire i valori una volta restituiti.

MetricValue

Un valore di una singola metrica da un'ora di inizio.

Campi
metric

Metric

La metrica per cui si applica il valore.

total_value

DimensionalMetricValue

Il valore aggregato totale per questa metrica. Impostato per l'opzione AGGREGATED_TOTAL.

dimensional_values[]

DimensionalMetricValue

Valori dimensionali per questa metrica.

MoreHours

I periodi di tempo durante i quali una sede è aperta per determinati tipi di attività.

Campi
hours_type_id

string

Obbligatorio. Tipo di orari. I clienti devono chiamare {#link businessCategories:BatchGet} per ottenere i tipi di orari supportati per le categorie delle loro sedi.

periods[]

TimePeriod

Obbligatorio. Una raccolta degli orari di apertura di questo luogo. Ogni periodo rappresenta un intervallo di orari in cui la sede è aperta durante la settimana.

MoreHoursType

Altri tipi di orari che un'attività può offrire, oltre a quello normale.

Campi
hours_type_id

string

Solo output. Un ID stabile fornito da Google per questo tipo di orario.

display_name

string

Solo output. Il nome visualizzato in inglese leggibile per il tipo di orario.

localized_display_name

string

Solo output. Il nome visualizzato localizzato leggibile per il tipo di orario.

NetworkState

Stato di una rete assicurativa relativa a questa località.

Enum
NETWORK_STATE_UNSPECIFIED Valore predefinito.
ACCEPTED Questa rete è accettata da questa località.
PENDING_ADD Esiste una richiesta in attesa per aggiungere questa rete all'elenco accettato.
PENDING_DELETE Esiste una richiesta in attesa di rimozione di questa rete dall'elenco accettato.
NOT_ACCEPTED Rete non accettata da questa località.

NotificationType

Tipo di notifica inviata all'argomento Cloud Pub/Sub.

Enum
NOTIFICATION_TYPE_UNSPECIFIED Nessun tipo di notifica. Non corrisponderà a nessuna notifica.
GOOGLE_UPDATE Per la sede sono disponibili aggiornamenti Google da esaminare. Il campo location_name nella notifica fornirà il nome della risorsa della località con gli aggiornamenti Google.
NEW_REVIEW È stata aggiunta una nuova recensione per la sede. Il campo review_name nella notifica indicherà il nome della risorsa della recensione che è stata aggiunta, mentre location_name avrà il nome della risorsa della località.
UPDATED_REVIEW È stata aggiornata una recensione sulla sede. Il campo review_name nella notifica indicherà il nome della risorsa della recensione che è stata aggiunta, mentre location_name avrà il nome della risorsa della località.
NEW_CUSTOMER_MEDIA Un nuovo elemento multimediale è stato aggiunto alla posizione da un utente di Google Maps. La notifica fornirà il nome della risorsa del nuovo elemento multimediale.
NEW_QUESTION Viene aggiunta una nuova domanda alla posizione. Nella notifica verrà fornito il nome della risorsa della domanda.
UPDATED_QUESTION Viene aggiornata una domanda sul luogo. Nella notifica verrà fornito il nome della risorsa della domanda.
NEW_ANSWER Viene aggiunta una nuova risposta alla posizione. La notifica fornirà il nome risorsa della domanda e della risposta.
UPDATED_ANSWER La risposta relativa alla posizione viene aggiornata. La notifica fornirà il nome risorsa della domanda e della risposta.
UPDATED_LOCATION_STATE Il valore LocationState della località è stato aggiornato. La notifica conterrà la maschera dei campi dei campi LocationState aggiornati.

Notifiche

Un argomento di Google Cloud Pub/Sub in cui è possibile pubblicare le notifiche quando una località viene aggiornata o è in corso una nuova recensione. Sarà presente una sola risorsa di impostazioni di notifica per account.

Campi
name

string

Solo output. Il nome della risorsa delle notifiche.

topic_name

string

L'argomento Google Cloud Pub/Sub che riceverà notifiche quando le località gestite da questo account vengono aggiornate. Se il criterio non viene configurato, non verranno pubblicate notifiche.

L'account mybusiness-api-pubsub@system.gserviceaccount.com deve disporre almeno delle autorizzazioni di pubblicazione per l'argomento Cloud Pub/Sub.

notification_types[]

NotificationType

Tipi di notifiche che verranno inviate all'argomento Cloud Pub/Sub. È necessario specificarne almeno uno. Per interrompere completamente la ricezione delle notifiche, utilizza DeleteNotifications.

NutritionFacts

Questo messaggio rappresenta i valori nutrizionali di un piatto.

Campi
calories

CaloriesFact

(Facoltativo) Calorie del piatto.

total_fat

NutritionFact

(Facoltativo) Informazioni sui grassi per un determinato piatto.

cholesterol

NutritionFact

(Facoltativo) Informazioni sul colesterolo per un determinato piatto.

sodium

NutritionFact

(Facoltativo) Informazioni sul sodio per un determinato piatto.

total_carbohydrate

NutritionFact

(Facoltativo) Informazioni sui carboidrati per un determinato piatto.

protein

NutritionFact

(Facoltativo) Informazioni sulle proteine di un determinato piatto.

CaloriesFact

Questo messaggio indica informazioni sulle calorie con un limite superiore e un limite inferiore. È necessario specificare un importo inferiore. Sia gli importi inferiori che quelli superiori sono numeri non negativi.

Campi
lower_amount

int32

Obbligatorio. Riduzione della quantità di calorie

upper_amount

int32

(Facoltativo) Quantità superiore di calorie

unit

EnergyUnit

Obbligatorio. Unità delle informazioni sulle calorie fornite.

EnergyUnit

Possibili unità di energia alimentare (calorie).

Enum
ENERGY_UNIT_UNSPECIFIED Unità energia non specificata
CALORIE Caloria
JOULE Joule

MassUnit

Possibili unità di massa.

Enum
MASS_UNIT_UNSPECIFIED Unità di massa non specificata
GRAM Gram
MILLIGRAM Milligrammo

NutritionFact

Questo messaggio indica le informazioni relative all'alimentazione con un limite superiore e uno inferiore e può essere rappresentato dall'unità di massa. È necessario specificare un importo inferiore. Sia gli importi inferiori che quelli superiori sono numeri non negativi.

Campi
lower_amount

double

Obbligatorio. Minore quantità di alimentazione

upper_amount

double

(Facoltativo) Nutrizione superiore

unit

MassUnit

Obbligatorio. Unità delle informazioni nutrizionali fornite.

OpenInfo

Informazioni relative allo stato di apertura dell'attività.

Campi
status

OpenForBusiness

Indica se la sede è attualmente aperta o meno. Tutte le sedi sono aperte per impostazione predefinita, a meno che non vengano aggiornate in modo da essere chiuse.

can_reopen

bool

Solo output. Indica se questa attività è idonea alla riapertura.

opening_date

Date

La data in cui la sede è stata aperta per la prima volta. Se non si conosce il giorno esatto, è possibile indicare solo mese e anno. La data deve essere nel passato o non essere successiva a un anno nel futuro.

OpenForBusiness

Indica lo stato di una posizione.

Enum
OPEN_FOR_BUSINESS_UNSPECIFIED Non specificato.
OPEN Indica che la sede è aperta.
CLOSED_PERMANENTLY Indica che la sede è stata chiusa definitivamente.
CLOSED_TEMPORARILY Indica che la sede è stata temporaneamente chiusa. Questo valore può essere applicato solo alle località pubblicate (ad es. location_state.is_published = true). Quando il campo dello stato viene aggiornato impostandolo su questo valore, i clienti devono impostare update_mask in modo esplicito su open_info.status. Durante la chiamata di aggiornamento non è possibile impostare altre maschere di aggiornamento. Si tratta di una limitazione temporanea che verrà allentata a breve.

PermissionLevel

Indica il livello di accesso dell'utente autenticato a questo account.

Enum
PERMISSION_LEVEL_UNSPECIFIED Non specificato.
OWNER_LEVEL L'utente dispone dell'autorizzazione a livello di proprietario.
MEMBER_LEVEL L'utente dispone dell'autorizzazione a livello di membro.

PhoneInput

Ingresso per la verifica tramite PHONE_CALL/SMS.

Campi
phone_number

string

Il numero di telefono da chiamare o a cui inviare gli SMS. Deve essere uno dei numeri di telefono presenti nelle opzioni idonee.

PlaceInfo

Definisce un'area rappresentata da un ID luogo.

Campi
name

string

Il nome localizzato del luogo. Ad esempio, Scottsdale, AZ.

place_id

string

L'ID del luogo. Deve corrispondere a una regione.

Luoghi

Definisce l'unione delle aree rappresentate da un insieme di luoghi.

Campi
place_infos[]

PlaceInfo

Le aree rappresentate dagli ID luogo. È consentito un massimo di 20 posti.

PointRadius

Un raggio intorno a un punto specifico (latitudine/longitudine).

Campi
latlng

LatLng

La latitudine/longitudine che specifica il centro di un'area definita dal raggio.

radius_km

float

La distanza in chilometri dell'area attorno al punto.

PreparationMethod

Metodo di preparazione di un piatto.

Enum
PREPARATION_METHOD_UNSPECIFIED Metodo di preparazione non specificato
BAKED Metodo cotto
BARBECUED Metodo Barbecue
BASTED Metodo basted
BLANCHED Metodo sbiancato
BOILED Metodo bollito
BRAISED Brasatura
CODDLED Metodo Coddled
FERMENTED Metodo fermentato
FRIED Metodo fritto
GRILLED Metodo alla griglia
KNEADED Metodo impastato
MARINATED Metodo marinato
PAN_FRIED Metodo in padella
PICKLED Metodo in salamoia
PRESSURE_COOKED Metodo di cottura a pressione
ROASTED Metodo arrosto
SAUTEED Metodo saltato
SEARED Metodo scottato
SIMMERED Metodo cotto
SMOKED Metodo affumicato
STEAMED Metodo vapore
STEEPED Metodo in salita
STIR_FRIED Metodo fritto
OTHER_METHOD Altro metodo

PriceList

Obsoleto: un elenco di informazioni sui prezzi degli articoli. I listini prezzi sono strutturati come uno o più listini prezzi, ciascuno contenente una o più sezioni con uno o più articoli. Ad esempio, i listini prezzi dei cibi possono rappresentare menu per colazione/pranzo/cena, con sezioni per hamburger/bistecca/pesce.

Campi
price_list_id

string

Obbligatorio. ID del listino prezzi. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località.

labels[]

Label

Obbligatorio. Etichette con tag di lingua per il listino prezzi.

source_url

string

URL di origine facoltativo della fonte da cui è stato recuperato il listino prezzi. Ad esempio, potrebbe trattarsi dell'URL della pagina di cui è stata eseguita automaticamente lo scraping per compilare le informazioni del menu.

sections[]

Section

Obbligatorio. Sezioni di questo listino prezzi. Ogni listino prezzi deve contenere almeno una sezione.

Etichetta

Etichetta da utilizzare durante la visualizzazione del listino prezzi, della sezione o dell'articolo.

Campi
display_name

string

Obbligatorio. Nome visualizzato del listino prezzi, della sezione o dell'articolo.

description

string

(Facoltativo) Descrizione del listino prezzi, della sezione o dell'articolo.

language_code

string

(Facoltativo) Il codice lingua BCP-47 a cui si applicano queste stringhe. È possibile impostare un solo set di etichette per lingua.

Sezione

Una sezione del listino prezzi contenente uno o più articoli.

Campi
section_id

string

Obbligatorio. ID della sezione. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località.

labels[]

Label

Obbligatorio. Etichette con tag lingua per la sezione. Ti consigliamo di non superare i 140 caratteri per i nomi e le descrizioni delle sezioni. È richiesto almeno un set di etichette.

section_type

SectionType

(Facoltativo) Tipo della sezione del listino prezzi corrente. Il valore predefinito è FOOD.

items[]

Item

Articoli contenuti in questa sezione del listino prezzi.

Elemento

Un singolo elemento dell'elenco. Ogni variante di un articolo nel listino prezzi deve avere un proprio articolo con i relativi dati sui prezzi.

Campi
item_id

string

Obbligatorio. ID dell'articolo. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località.

labels[]

Label

Obbligatorio. Etichette con tag lingua per l'articolo. Ti consigliamo di non superare i 140 caratteri per i nomi degli articoli e di 250 caratteri per le descrizioni. È richiesto almeno un set di etichette.

price

Money

(Facoltativo) Prezzo dell'articolo.

SectionType

Tipo di sezione.

Enum
SECTION_TYPE_UNSPECIFIED Non specificato.
FOOD La sezione contiene elementi che rappresentano il cibo.
SERVICES La sezione contiene elementi che rappresentano i servizi.

Profilo

Tutte le informazioni relative al profilo della sede.

Campi
description

string

Descrizione del luogo con i tuoi comandi vocali e non modificabile da nessun altro.

Domanda

Rappresenta una singola domanda e alcune delle sue risposte.

Campi
name

string

Solo output. Il nome univoco della domanda. accounts/*/locations/*/questions/*

author

Author

Solo output. L'autore della domanda.

upvote_count

int32

Solo output. Il numero di voti positivi per la domanda.

text

string

Il testo della domanda. Deve contenere almeno tre parole e la lunghezza totale deve essere maggiore o uguale a 10 caratteri. La lunghezza massima è di 4096 caratteri.

create_time

Timestamp

Solo output. Il timestamp in cui è stata scritta la domanda.

update_time

Timestamp

Solo output. Il timestamp relativo all'ultima modifica della domanda.

top_answers[]

Answer

Solo output. Un elenco di risposte alla domanda, ordinate in base ai voti positivi. Questo potrebbe non essere un elenco completo di risposte, a seconda dei parametri della richiesta (answers_per_question)

total_answer_count

int32

Solo output. Il numero totale di risposte pubblicate per questa domanda.

RepeatedEnumAttributeValue

Valori per un attributo con value_type di REPEATED_ENUM. È costituito da due elenchi di ID valore: quelli impostati (true) e quelli non impostati (false). I valori assenti sono considerati sconosciuti. È necessario specificare almeno un valore.

Campi
set_values[]

string

Valori enum impostati.

unset_values[]

string

Valori enum non impostati.

ReportGoogleLocationRequest

Messaggio di richiesta per la segnalazione di un GoogleLocation.

Campi
name

string

Nome risorsa di [GoogleLocation], nel formato googleLocations/{googleLocationId}.

location_group_name

string

(Facoltativo) Il nome della risorsa del gruppo di località per cui viene segnalata questa località Google, nel formato accounts/{account_id}.

report_reason_elaboration

string

(Facoltativo) Un'immissione di testo per elaborare il motivo per cui l'utente sta segnalando questa posizione. La lunghezza massima è di 512 caratteri.

report_reason_language_code

string

(Facoltativo) Codice del linguaggio BCP 47 utilizzato in report_reason_elaboration.

Campo unione report_reason. Motivo per cui questa località viene segnalata. È necessario specificare un motivo. report_reason può essere solo uno dei seguenti:
report_reason_bad_location

BadLocationReason

Il motivo per cui l'utente segnala questa posizione quando il problema riguarda la località stessa.

report_reason_bad_recommendation

BadRecommendationReason

Il motivo per cui l'utente segnala questa posizione quando il problema riguarda il consiglio. Questo report è utile se la località è stata consigliata all'account Profilo dell'attività.

BadLocationReason

Una serie di possibili motivi per segnalare una posizione quando c'è un problema con la qualità dei dati nella località stessa.

Enum
BAD_LOCATION_REASON_UNSPECIFIED Non specificato.
NOT_A_LOCATION La posizione consigliata non è una località effettiva.
PERMANENTLY_CLOSED La sede consigliata è chiusa definitivamente.
DOES_NOT_EXIST La località consigliata non esiste.
SPAM La posizione consigliata è spam, falsa o offensiva.
NOT_A_BUSINESS La posizione consigliata è un luogo privato o un'abitazione.
MOVED

La posizione consigliata è stata spostata in una nuova posizione.

Deve essere accompagnato da un report_reason_elaboration che specifica il nuovo indirizzo.

DUPLICATE La località consigliata è un duplicato di un'altra località.

BadRecommendationReason

Una serie di possibili motivi per segnalare una località quando si verifica un problema con la qualità del consiglio (quando questa località viene consigliata all'utente).

Enum
BAD_RECOMMENDATION_REASON_UNSPECIFIED Non specificato.
NOT_A_STORE_FRONT La posizione consigliata non è una vetrina.
NOT_PART_OF_SUGGESTED_CHAIN

La posizione consigliata non appartiene alla catena suggerita in chain_display_name nella località restituita.

Deve essere accompagnato da un report_reason_elaboration che specifica il nome della catena corretta.

IRRELEVANT

La località consigliata non è pertinente per l'utente.

Deve essere accompagnata da un report_reason_elaboration che indichi il motivo per cui il consiglio non è pertinente.

ReportLocalPostInsightsRequest

Messaggio di richiesta per Insights.ReportLocalPostInsights

Campi
name

string

Obbligatorio. Il nome della sede per la quale recuperare gli approfondimenti.

local_post_names[]

string

Obbligatorio. L'elenco di post per i quali recuperare dati degli approfondimenti. Tutti i post devono appartenere alla posizione il cui nome è specificato nel campo name.

basic_request

BasicMetricsRequest

Una richiesta per includere nel report informazioni sulle metriche di base. Questa richiesta si applica a tutti i post richiesti.

ReportLocalPostInsightsResponse

Messaggio di risposta per Insights.ReportLocalPostInsights

Campi
name

string

local_post_metrics[]

LocalPostMetrics

Una voce per post richiesto corrispondente a questa località.

time_zone

string

Fuso orario (ID fuso orario IANA, ad es. "Europa/Londra") della località.

ReportLocationInsightsRequest

Messaggio di richiesta per Insights.ReportLocationInsights.

Campi
name

string

Il nome della risorsa dell'account.

location_names[]

string

Una raccolta di località per cui recuperare gli insight, specificate dai nomi.

basic_request

BasicMetricsRequest

Una richiesta per includere nel report informazioni sulle metriche di base.

driving_directions_request

DrivingDirectionMetricsRequest

Una richiesta per includere nel report informazioni sulle richieste di indicazioni stradali.

ReportLocationInsightsResponse

Messaggio di risposta per Insights.ReportLocationInsights.

Campi
location_metrics[]

LocationMetrics

Una raccolta di valori di metriche per località.

location_driving_direction_metrics[]

LocationDrivingDirectionMetrics

Una raccolta di valori per le metriche relative alle indicazioni stradali.

Rivedi

Solo output. Rappresenta la recensione di una località.

Campi
name

string

Nome della risorsa. Per la revisione ha il formato accounts/{account_id}/locations/{location_id}/reviews/{review_id}

review_id

string

L'identificatore univoco criptato.

reviewer

Reviewer

L'autore della recensione.

star_rating

StarRating

La valutazione a stelle della recensione.

comment

string

Corpo della recensione come testo normale con markup.

create_time

Timestamp

Il timestamp di quando è stata scritta la recensione.

update_time

Timestamp

Il timestamp relativo all'ultima modifica della recensione.

review_reply

ReviewReply

Risposta del proprietario/gestore di questa sede a questa recensione.

Autore recensione

Rappresenta l'autore della recensione.

Campi
profile_photo_url

string

Il link alla foto del profilo del recensore. Compilato solo se is_anonymous è falso.

display_name

string

Il nome del recensore. Compilato con il nome reale del recensore solo se is_anonymous è falso.

is_anonymous

bool

Indica se il recensore ha scelto di rimanere anonimo.

StarRating

La valutazione a stelle da cinque, dove cinque corrisponde alla valutazione più alta.

Enum
STAR_RATING_UNSPECIFIED Non specificato.
ONE Una stella su un massimo di cinque.
TWO Due stelle su un massimo di cinque.
THREE Tre stelle su un massimo di cinque.
FOUR Quattro stelle su un massimo di cinque.
FIVE La valutazione a stelle massima.

ReviewReply

Rappresenta la risposta a una recensione del proprietario/gestore della sede.

Campi
comment

string

Il corpo della risposta come testo normale con i markup. La lunghezza massima è 4096 byte.

update_time

Timestamp

Solo output. Il timestamp relativo all'ultima modifica della risposta.

SearchChainsRequest

Messaggio di richiesta per locations.SearchChains.

Campi
chain_display_name

string

Cerca una catena in base al nome. Sono supportate le query esatte/parziali/fuzzy/correlate. Esempi: "walmart", "wal-mart", "walmmmart", "沃尔玛"

result_count

int32

Il numero massimo di catene corrispondenti da restituire da questa query. Il valore predefinito è 10. Il valore massimo possibile è 500.

SearchChainsResponse

Messaggio di risposta per locations.SearchChains.

Campi
chains[]

Chain

Catene che corrispondono a chain_display_name oggetto della query in SearchChainsRequest. Se non vengono trovate corrispondenze, il campo è vuoto. I risultati sono elencati in ordine di pertinenza.

SearchGoogleLocationsRequest

Messaggio di richiesta per GoogleLocations.SearchGoogleLocations.

Campi
result_count

int32

Il numero di corrispondenze da restituire. Il valore predefinito è 3, con un massimo di 10. Tieni presente che, se vengono richieste altre, la latenza può aumentare. Non è prevista l'impaginazione.

Campo unione search_query. Query di ricerca. Può essere fornito come oggetto posizione o come query di stringa. search_query può essere solo uno dei seguenti:
location

Location

Località da cercare. Se fornite, troveranno le sedi che corrispondono ai dettagli della sede forniti.

query

string

Query di testo da cercare. I risultati di ricerca provenienti da una stringa di query saranno meno precisi di quanto accadrebbe se venisse fornita una posizione esatta, ma potrebbero fornire più corrispondenze inesatte.

SearchGoogleLocationsResponse

Messaggio di risposta relativo a GoogleLocations.SearchGoogleLocations.

Campi
google_locations[]

GoogleLocation

Un insieme di località Google che potrebbero corrispondere alla richiesta specificata, ordinate in ordine decrescente.

ServiceAreaBusiness

Le attività al domicilio del cliente forniscono il proprio servizio presso la sede del cliente, ad esempio un fabbro o un idraulico.

Campi
business_type

BusinessType

Indica il type dell'attività al domicilio del cliente.

Campo unione coverageArea. Indica l'area di copertura in cui l'attività offre il servizio. coverageArea può essere solo uno dei seguenti:
radius

PointRadius

Solo output. L'area servita dall'attività commerciale intorno a un punto.

places

Places

L'area servita da questa attività definita mediante una serie di luoghi.

BusinessType

Indica se questa attività offre servizi solo in loco presso una sede del cliente (ad es. un carro attrezzi) o sia presso un indirizzo che in loco (ad esempio una pizzeria con zona pranzo, che effettua anche consegne ai clienti).

Enum
BUSINESS_TYPE_UNSPECIFIED Solo output. Non specificato.
CUSTOMER_LOCATION_ONLY Offre servizio solo nell'area circostante (non presso l'indirizzo dell'attività commerciale).
CUSTOMER_AND_BUSINESS_LOCATION Offre il servizio presso l'indirizzo dell'attività e nella zona circostante.

ServiceBusinessContext

Dati aggiuntivi per la verifica dell'attività di servizi.

Campi
address

PostalAddress

L'indirizzo di verifica della sede. Viene utilizzato per attivare altre opzioni di verifica o per inviare una cartolina.

ServiceList

Un elenco di servizi contenente uno o più elementi del servizio.

Campi
name

string

Obbligatorio. Identificatore Google di questa sede nel formato: accounts/{account_id}/locations/{location_id}/serviceList

service_items[]

ServiceItem

Articoli di servizio contenuti in questo elenco di servizi. Gli elementi di servizio duplicati verranno rimossi automaticamente.

ServiceItem

Un messaggio che descrive un singolo elemento del servizio. Viene utilizzato per descrivere il tipo di servizio fornito dal commerciante. Ad esempio, il taglio di capelli può essere un servizio.

Campi
is_offered

bool

(Facoltativo) Questo campo consente di stabilire se il servizio di immissione è offerto o meno dal commerciante.

price

Money

(Facoltativo) Rappresenta il prezzo monetario dell'articolo del servizio. Quando includi un prezzo, ti consigliamo di impostare il valore Currency_code e le unità di misura.

Campo unione service_item_info. Uno dei seguenti campi deve essere sempre impostato. service_item_info può essere solo uno dei seguenti:
structured_service_item

StructuredServiceItem

Questo campo verrà impostato in caso di dati di servizi strutturati.

free_form_service_item

FreeFormServiceItem

Questo campo viene impostato per i dati di servizi in formato libero.

FreeFormServiceItem

Rappresenta un servizio in formato libero offerto dal commerciante. Si tratta di servizi che non sono esposti nell'ambito dei dati dei nostri servizi della struttura. Il commerciante inserisce manualmente i nomi di questi servizi tramite una piattaforma geocommerciante.

Campi
category_id

string

Obbligatorio. category_id e service_type_id devono corrispondere alle possibili combinazioni fornite nel messaggio Category.

label

Label

Obbligatorio. Etichette con tag lingua per l'articolo. Ti consigliamo di non superare i 140 caratteri per i nomi degli articoli e di 250 caratteri per le descrizioni. Questo campo deve essere impostato solo se l'input è un elemento di servizio personalizzato. I tipi di servizio standardizzati devono essere aggiornati tramite service_type_id.

StructuredServiceItem

Rappresenta un servizio strutturato offerto dal commerciante. Ad esempio: servizi igienici_installation.

Campi
service_type_id

string

Obbligatorio. Il campo service_type_id è un ID univoco fornito da Google che puoi trovare in ServiceTypeMetadata. Queste informazioni sono fornite dal servizio RPC BatchGetBusinessCategories.

description

string

(Facoltativo) Descrizione dell'elemento di servizio strutturato. Il limite di caratteri è 300.

ServiceType

Un messaggio che descrive un tipo di servizio offerto dall'attività.

Campi
service_type_id

string

Solo output. Un ID stabile (fornito da Google) per questo tipo di servizio.

display_name

string

Solo output. Il nome visualizzato leggibile per il tipo di servizio.

SpecialHourPeriod

Rappresenta un singolo periodo di tempo in cui l'orario di apertura di una sede è diverso dal normale orario di apertura. Un periodo di ore speciale deve rappresentare un intervallo inferiore a 24 ore. I valori open_time e start_date devono essere precedenti a close_time e end_date. I close_time e end_date possono estendere fino alle 11:59 del giorno successivo al start_date specificato. Ad esempio, i seguenti input sono validi:

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

I seguenti input non sono validi:

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
Campi
start_date

Date

La data di calendario in cui inizia questo periodo di un'ora speciale.

open_time

string

Il tempo effettivo su start_date all'apertura di una sede, espresso nel formato esteso ISO 8601 di 24 ore. (hh:mm) I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. Deve essere specificato se is_closed è falso.

end_date

Date

La data di calendario di questo periodo di un'ora speciale. Se il campo end_date non viene configurato, il valore predefinito è la data specificata in start_date. Se impostato, questo campo deve essere uguale o al massimo 1 giorno dopo start_date.

close_time

string

Il tempo totale di esecuzione su end_date alla chiusura di una sede, espresso nel formato esteso ISO 8601 di 24 ore. (hh:mm) I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. Deve essere specificato se is_closed è falso.

is_closed

bool

Se true, end_date, open_time e close_time vengono ignorati e la data specificata in start_date viene considerata come la sede chiusa per l'intera giornata.

SpecialHours

Rappresenta una serie di periodi di tempo in cui l'orario di apertura di una sede è diverso dal normale orario di apertura.

Campi
special_hour_periods[]

SpecialHourPeriod

Un elenco di eccezioni al normale orario di apertura dell'attività.

Piccante

Il livello di piccantezza di un alimento.

Enum
SPICINESS_UNSPECIFIED Livello non specificato
MILD Denominazione di piccante leggera.
MEDIUM Denominazione di piccante medio.
HOT Denominazione di piccante. Il livello più piccante.

StartUploadMediaItemDataRequest

Messaggio di richiesta per Media.StartUploadMediaItemData.

Campi
parent

string

Il nome della risorsa della posizione in cui deve essere aggiunto questo elemento multimediale.

TimeInterval

Un intervallo di tempo incluso. Per essere valido, deve contenere tutti i campi.

Campi
start_date

Date

La data di inizio del periodo.

start_time

TimeOfDay

L'ora di inizio del periodo.

end_date

Date

La data di fine del periodo.

end_time

TimeOfDay

L'ora di fine di questo periodo.

TimePeriod

Rappresenta un periodo di tempo in cui l'attività è aperta, a partire dal giorno/ora di apertura specificati e dalla chiusura nel giorno/ora di chiusura specificati. L'orario di chiusura deve essere successivo all'orario di apertura, ad esempio più tardi nella stessa giornata o in un giorno successivo.

Campi
open_day

DayOfWeek

Indica il valore day of the week in cui inizia questo periodo.

open_time

string

Ora nel formato esteso ISO 8601 di 24 ore (hh:mm). I valori validi sono: 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo giorno specificato.

close_day

DayOfWeek

Indica il valore day of the week in cui termina il periodo.

close_time

string

Ora nel formato esteso ISO 8601 di 24 ore (hh:mm). I valori validi sono: 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo giorno specificato.

TimeRange

Un intervallo di tempo. I dati verranno estratti nell'intervallo come inverval semiaperto (ovvero [start_time, end_time)).

Campi
start_time

Timestamp

Timestamp dell'inizio dell'intervallo (incluso).

end_time

Timestamp

Timestamp per la fine dell'intervallo (escluso).

TransferLocationRequest

Messaggio di richiesta per locations.TransferLocation.

Campi
name

string

Il nome della sede da trasferire.

to_account

string

Nome della risorsa dell'account in cui trasferire la località (ad esempio "accounts/8675309").

UpdateAccountAdminRequest

Messaggio di richiesta per AccessControl.UpdateAccountAdmin.

Campi
name

string

Il nome della risorsa dell'amministratore da aggiornare.

admin

Admin

L'amministratore aggiornato. Nota: l'unico campo modificabile è role. Tutti gli altri campi vengono ignorati.

UpdateAccountRequest

Messaggio di richiesta per Accounts.UpdateAccount.

Campi
name

string

Il nome dell'account da aggiornare.

account

Account

I dati dell'account aggiornati. Nota: l'unico campo modificabile è account_name.

validate_only

bool

Se true, la richiesta viene convalidata senza aggiornare effettivamente l'account.

UpdateFoodMenusRequest

Messaggio di richiesta per FoodMenu.UpdateFoodMenus

Campi
food_menus

FoodMenus

Obbligatorio. Le informazioni aggiornate del menu alimentare. Puoi annullare l'impostazione del menu eseguendo l'aggiornamento senza sezioni del menu.

update_mask

FieldMask

(Facoltativo) I campi specifici da aggiornare. Se non viene specificata alcuna maschera, questo viene considerato come un aggiornamento completo e tutti i campi vengono impostati sui valori trasmessi, il che potrebbe includere l'annullamento dell'impostazione dei campi vuoti nella richiesta. Gli elementi dei campi ripetuti non possono essere aggiornati singolarmente. Nota: "nome" di FoodMenus è l'identificatore della risorsa che non è aggiornabile.

UpdateHealthProviderAttributesRequest

Messaggio di richiesta per HealthProviderAttributes.UpdateHealthProviderAttributes

Campi
health_provider_attributes

HealthProviderAttributes

Obbligatorio. Attributi del fornitore di servizi sanitari aggiornati.

update_mask

FieldMask

(Facoltativo) I campi specifici da aggiornare. Se non viene specificata alcuna maschera, questo viene considerato come un aggiornamento completo e tutti i campi vengono impostati sui valori trasmessi, il che potrebbe includere l'annullamento dell'impostazione dei campi vuoti nella richiesta. Nella V1, è necessario aggiornare solo il campo housing_networks. In seguito saranno supportati altri attributi.

UpdateLocalPostRequest

Messaggio di richiesta per UpdateLocalPost.

Campi
name

string

Il nome del post locale da aggiornare.

local_post

LocalPost

Le informazioni sui post locali aggiornate.

update_mask

FieldMask

I campi specifici da aggiornare. È necessario specificare ogni campo che viene aggiornato nella maschera.

UpdateLocationAdminRequest

Messaggio di richiesta per AccessControl.UpdateLocationAdmin.

Campi
name

string

Il nome della risorsa dell'amministratore da aggiornare.

admin

Admin

L'amministratore aggiornato. Nota: l'unico campo modificabile è role. Tutti gli altri campi vengono ignorati.

UpdateLocationRequest

Messaggio di richiesta per locations.UpdateLocation.

Campi
name

string

Il nome della sede da aggiornare.

location

Location

Le informazioni sulla posizione aggiornate.

update_mask

FieldMask

I campi specifici da aggiornare. Se non viene specificata alcuna maschera, questo viene considerato come un aggiornamento completo e tutti i campi vengono impostati sui valori trasmessi, il che potrebbe includere l'annullamento dell'impostazione dei campi vuoti nella richiesta.

validate_only

bool

Se true, la richiesta viene convalidata senza aggiornare effettivamente la località.

attribute_mask

FieldMask

Gli ID degli attributi da aggiornare. Verranno aggiornati solo gli attributi indicati nella maschera. Se un attributo è presente nella maschera e non nella località, verrà rimosso. Una maschera vuota aggiorna tutti gli attributi.

Ogni volta che questo campo viene impostato, update_mask deve includere gli attributi in uno dei campi da aggiornare.

UpdateMediaItemRequest

Messaggio di richiesta per Media.UpdateMediaItem.

Campi
name

string

Il nome dell'elemento multimediale da aggiornare.

media_item

MediaItem

L'elemento multimediale da aggiornare.

È possibile aggiornare solo l'ID articolo della categoria o del listino prezzi.

update_mask

FieldMask

I campi specifici da aggiornare. Se non viene specificata alcuna maschera, questa operazione viene considerata come un aggiornamento completo e tutti i campi modificabili vengono impostati sui valori trasmessi.

UpdateNotificationsRequest

Messaggio di richiesta per Accounts.Updatenotifications.

Campi
name

string

Il nome della risorsa delle impostazioni di notifica.

notifications

Notifications

Le impostazioni di notifica aggiornate.

UpdateQuestionRequest

Messaggio di richiesta per questionsAndAnswers.UpdateQuestion

Campi
name

string

Il nome della domanda da aggiornare.

question

Question

La domanda aggiornata.

UpdateReviewReplyRequest

Messaggio di richiesta per Reviews.UpdateReviewReview.

Campi
name

string

Il nome della recensione a cui rispondere.

review_reply

ReviewReply

La risposta alla recensione. Se esiste già una risposta, questa sostituirà la precedente.

UpdateServiceListRequest

Messaggio di aggiornamento della richiesta di elenco dei servizi.

Campi
service_list

ServiceList

(Facoltativo) Le informazioni sull'elenco dei servizi aggiornate. Se lasci questo campo vuoto, l'API eliminerà ServiceList. Se un ServiceList è impostato, l'API sostituirà il ServiceList originale con quello impostato.

update_mask

FieldMask

(Facoltativo) I campi specifici da aggiornare. Se non viene specificata alcuna maschera, questo viene considerato come un aggiornamento completo e tutti i campi vengono impostati sui valori trasmessi, il che potrebbe includere l'annullamento dell'impostazione dei campi vuoti nella richiesta. Gli elementi dei campi ripetuti non possono essere aggiornati singolarmente.

UpsertAnswerRequest

Messaggio di richiesta per questionsAndAnswers.UpsertAnswer

Campi
parent

string

Il nome della domanda per cui scrivere una risposta.

answer

Answer

La nuova risposta.

UrlAttributeValue

Valori per un attributo con un value_type di URL.

Campi
url

string

L'URL.

ValidationError

Descrive gli errori di convalida in una richiesta del client.

Campi
error_details[]

ErrorDetail

Descrive i singoli errori di convalida con codici di errore interi.

Verifica

Una verifica rappresenta un tentativo di verifica effettuato per una sede.

Campi
name

string

Nome risorsa della verifica.

method

VerificationMethod

Il metodo di verifica.

state

VerificationState

Lo stato della verifica.

create_time

Timestamp

Il timestamp di richiesta della verifica.

VerificationState

Tutti gli stati di verifica possibili.

Enum
VERIFICATION_STATE_UNSPECIFIED Valore predefinito, causerà errori.
PENDING In attesa della verifica.
COMPLETED La verifica è stata completata.
FAILED Verifica non riuscita.

VerificationMethod

Specifica i processi utilizzati da Google per verificare una località.

Enum
VERIFICATION_METHOD_UNSPECIFIED Valore predefinito, causerà errori.
ADDRESS Invia una cartolina con un PIN di verifica a un indirizzo postale specifico. Il PIN viene utilizzato per completare la verifica con Google.
EMAIL Invia un'email con un PIN di verifica a un indirizzo email specifico. Il PIN viene utilizzato per completare la verifica con Google.
PHONE_CALL Effettuare una telefonata con un PIN di verifica a un numero di telefono specifico. Il PIN viene utilizzato per completare la verifica con Google.
SMS Invia un SMS con un PIN di verifica a un numero di telefono specifico. Il PIN viene utilizzato per completare la verifica con Google.
AUTO Verifica la sede senza ulteriori azioni dell'utente. Questa opzione potrebbe non essere disponibile per tutte le località.

VerificationOption

L'opzione di verifica indica come verificare la sede (indicata dal metodo di verifica) e dove verrà inviata la verifica (indicata dai dati visualizzati).

Campi
verification_method

VerificationMethod

Metodo per verificare la località.

Campo unione DisplayData. Uno dei dati di visualizzazione. I dati devono corrispondere al metodo. Vuoto se il metodo corrispondente non ha dati di visualizzazione. DisplayData può essere solo uno dei seguenti:
phone_data

PhoneVerificationData

Impostalo solo se il metodo è PHONE_CALL o SMS.

address_data

AddressVerificationData

Da impostare solo se il metodo è MAIL.

email_data

EmailVerificationData

Impostalo solo se il metodo è EMAIL.

AddressVerificationData

Mostra i dati per le verifiche tramite cartolina.

Campi
business_name

string

Nome dell'attività del commerciante.

address

PostalAddress

Indirizzo a cui è possibile inviare una cartolina.

EmailVerificationData

Mostra i dati per le verifiche via email.

Campi
domain_name

string

Nome di dominio nell'indirizzo email. ad es. &quot;gmail.com&quot; in foo@gmail.com

user_name

string

Nome utente nell'indirizzo email. ad es. "foo" in foo@gmail.com

is_user_name_editable

bool

Indica se il cliente può fornire un nome utente diverso.

PhoneVerificationData

Mostra i dati per le verifiche telefoniche, ad esempio telefonata, sms.

Campi
phone_number

string

Numero di telefono a cui verrà inviato il PIN.

VerifyLocationRequest

Messaggio di richiesta per Verifications.VerifyLocation.

Campi
name

string

Nome risorsa della località da verificare.

method

VerificationMethod

Metodo di verifica.

language_code

string

Il codice lingua BCP 47 che rappresenta la lingua da utilizzare per la procedura di verifica.

context

ServiceBusinessContext

Informazioni contestuali aggiuntive per la verifica delle attività di servizi. Obbligatorio per le sedi il cui tipo di attività è CUSTOMER_LOCATION_ONLY. Per la verifica dell'indirizzo ADDRESS, l'indirizzo verrà utilizzato per l'invio della cartolina postale. Per gli altri metodi, deve essere uguale a quello trasmesso a FetchVerificaOptions. Se è impostato per altri tipi di sedi dell'attività commerciale, verrà visualizzato il valore INVALID_ARGUMENT.

Campo unione RequestData. Dati di input dell'utente per un metodo specifico oltre ai dati di visualizzazione. I dati devono corrispondere al metodo richiesto. Lascia vuoto il campo se non sono necessari dati. RequestData può essere solo uno dei seguenti:
email_input

EmailInput

Il valore inserito per il metodo EMAIL.

address_input

AddressInput

Input per il metodo ADDRESS.

phone_input

PhoneInput

Input per il metodo PHONE_CALL/SMS

VerifyLocationResponse

Messaggio di risposta relativo a Verifications.VerifyLocation.

Campi
verification

Verification

La richiesta di verifica creata.