Indice
AccessControl(interfaccia) (deprecata)Accounts(interfaccia) (deprecata)BusinessCategories(interfaccia)BusinessMessagingService(interfaccia)Followers(interfaccia)FoodMenuService(interfaccia)GoogleLocations(interfaccia)HealthProviderAttributesService(interfaccia)Insights(interfaccia)InsuranceNetworkService(interfaccia)LocalPosts(interfaccia)Locations(interfaccia)Media(interfaccia)QuestionsAndAnswers(interfaccia)Reviews(interfaccia)ServiceLists(interfaccia)Verifications(interfaccia)AcceptInvitationRequest(messaggio)Account(messaggio) (deprecato)Account.OrganizationInfo(messaggio)AccountRole(enum)AccountState(messaggio)AccountState.AccountStatus(enum)AccountType(enum)AdWordsLocationExtensions(messaggio)AddressInput(messaggio)Admin(messaggio)Admin.AdminRole(enum)AlertType(enum)Allergen(enum)Answer(messaggio)AssociateLocationRequest(messaggio)Attribute(messaggio)AttributeMetadata(messaggio)AttributeMetadata.AttributeValueMetadata(messaggio)AttributeValueType(enum)Author(messaggio)Author.AuthorType(enum)BasicMetricsRequest(messaggio)BatchGetBusinessCategoriesRequest(messaggio)BatchGetBusinessCategoriesResponse(messaggio)BatchGetLocationsRequest(messaggio)BatchGetLocationsResponse(messaggio)BatchGetReviewsRequest(messaggio)BatchGetReviewsResponse(messaggio)BusinessHours(messaggio)CallToAction(messaggio)CallToAction.ActionType(enum)Category(messaggio)CategoryView(enum)Chain(messaggio)Chain.ChainName(messaggio)Chain.ChainUrl(messaggio)ClearLocationAssociationRequest(messaggio)CompleteVerificationRequest(messaggio)CompleteVerificationResponse(messaggio)CreateAccountAdminRequest(messaggio)CreateAccountRequest(messaggio)CreateLocalPostRequest(messaggio)CreateLocationAdminRequest(messaggio)CreateLocationRequest(messaggio)CreateMediaItemRequest(messaggio)CreateQuestionRequest(messaggio)DeclineInvitationRequest(messaggio)DeleteAccountAdminRequest(messaggio)DeleteAnswerRequest(messaggio)DeleteLocalPostRequest(messaggio)DeleteLocationAdminRequest(messaggio)DeleteLocationRequest(messaggio)DeleteMediaItemRequest(messaggio)DeleteNotificationsRequest(messaggio)DeleteQuestionRequest(messaggio)DeleteReviewReplyRequest(messaggio)DietaryRestriction(enum)DimensionalMetricValue(messaggio)DimensionalMetricValue.TimeDimension(messaggio)DrivingDirectionMetricsRequest(messaggio)DrivingDirectionMetricsRequest.NumDays(enum)EmailInput(messaggio)ErrorDetail(messaggio)ErrorDetail.ErrorCode(enum)FetchVerificationOptionsRequest(messaggio)FetchVerificationOptionsResponse(messaggio)FindMatchingLocationsRequest(messaggio)FindMatchingLocationsResponse(messaggio)FollowersMetadata(messaggio)FoodMenu(messaggio)FoodMenu.Cuisine(enum)FoodMenuItem(messaggio)FoodMenuItemAttributes(messaggio)FoodMenuItemAttributes.Ingredient(messaggio)FoodMenuItemAttributes.PortionSize(messaggio)FoodMenuItemOption(messaggio)FoodMenuSection(messaggio)FoodMenus(messaggio)GenerateAccountNumberRequest(messaggio)GetAccountRequest(messaggio)GetChainRequest(messaggio)GetCustomerMediaItemRequest(messaggio)GetFollowersMetadataRequest(messaggio)GetFoodMenusRequest(messaggio)GetHealthProviderAttributesRequest(messaggio)GetLocalPostRequest(messaggio)GetLocationRequest(messaggio)GetMediaItemRequest(messaggio)GetNotificationsRequest(messaggio)GetReviewRequest(messaggio)GetServiceListRequest(messaggio)GoogleLocation(messaggio)GoogleUpdatedLocation(messaggio)HealthProviderAttributes(messaggio)InsuranceNetwork(messaggio)InternalError(messaggio)Invitation(messaggio)Invitation.TargetLocation(messaggio)ListAccountAdminsRequest(messaggio)ListAccountAdminsResponse(messaggio)ListAccountsRequest(messaggio)ListAccountsResponse(messaggio)ListAnswersRequest(messaggio)ListAnswersResponse(messaggio)ListAttributeMetadataRequest(messaggio)ListAttributeMetadataResponse(messaggio)ListBusinessCategoriesRequest(messaggio)ListBusinessCategoriesResponse(messaggio)ListCustomerMediaItemsRequest(messaggio)ListCustomerMediaItemsResponse(messaggio)ListInsuranceNetworksRequest(messaggio)ListInsuranceNetworksResponse(messaggio)ListInvitationsRequest(messaggio)ListInvitationsRequest.TargetType(enum)ListInvitationsResponse(messaggio)ListLocalPostsRequest(messaggio)ListLocalPostsResponse(messaggio)ListLocationAdminsRequest(messaggio)ListLocationAdminsResponse(messaggio)ListLocationsRequest(messaggio)ListLocationsResponse(messaggio)ListMediaItemsRequest(messaggio)ListMediaItemsResponse(messaggio)ListQuestionsRequest(messaggio)ListQuestionsResponse(messaggio)ListRecommendedGoogleLocationsRequest(messaggio)ListRecommendedGoogleLocationsResponse(messaggio)ListReviewsRequest(messaggio)ListReviewsResponse(messaggio)ListVerificationsRequest(messaggio)ListVerificationsResponse(messaggio)LocalPost(messaggio)LocalPost.LocalPostState(enum)LocalPostEvent(messaggio)LocalPostMetrics(messaggio)LocalPostOffer(messaggio)LocalPostTopicType(enum)Location(messaggio)Location.Metadata(messaggio)Location.Metadata.Duplicate(messaggio)Location.Metadata.Duplicate.Access(enum)Location.RelationshipData(messaggio)LocationDrivingDirectionMetrics(messaggio)LocationDrivingDirectionMetrics.TopDirectionSources(messaggio)LocationDrivingDirectionMetrics.TopDirectionSources.RegionCount(messaggio)LocationKey(messaggio)LocationMetrics(messaggio)LocationReview(messaggio)LocationState(messaggio)MatchedLocation(messaggio)MediaItem(messaggio)MediaItem.Attribution(messaggio)MediaItem.Dimensions(messaggio)MediaItem.LocationAssociation(messaggio)MediaItem.LocationAssociation.Category(enum)MediaItem.MediaFormat(enum)MediaItem.MediaInsights(messaggio)MediaItemDataRef(messaggio)MenuLabel(messaggio)Metric(enum)MetricOption(enum)MetricRequest(messaggio)MetricValue(messaggio)MoreHours(messaggio)MoreHoursType(messaggio)NetworkState(enum)NotificationType(enum)Notifications(messaggio)NutritionFacts(messaggio)NutritionFacts.CaloriesFact(messaggio)NutritionFacts.EnergyUnit(enum)NutritionFacts.MassUnit(enum)NutritionFacts.NutritionFact(messaggio)OpenInfo(messaggio)OpenInfo.OpenForBusiness(enum)PermissionLevel(enum)PhoneInput(messaggio)PlaceInfo(messaggio)Places(messaggio)PointRadius(messaggio)PreparationMethod(enum)PriceList(messaggio) (deprecato)PriceList.Label(messaggio)PriceList.Section(messaggio)PriceList.Section.Item(messaggio)PriceList.Section.SectionType(enum)Profile(messaggio)Question(messaggio)RepeatedEnumAttributeValue(messaggio)ReportGoogleLocationRequest(messaggio)ReportGoogleLocationRequest.BadLocationReason(enum)ReportGoogleLocationRequest.BadRecommendationReason(enum)ReportLocalPostInsightsRequest(messaggio)ReportLocalPostInsightsResponse(messaggio)ReportLocationInsightsRequest(messaggio)ReportLocationInsightsResponse(messaggio)Review(messaggio)Review.Reviewer(messaggio)Review.StarRating(enum)ReviewReply(messaggio)SearchChainsRequest(messaggio)SearchChainsResponse(messaggio)SearchGoogleLocationsRequest(messaggio)SearchGoogleLocationsResponse(messaggio)ServiceAreaBusiness(messaggio)ServiceAreaBusiness.BusinessType(enum)ServiceBusinessContext(messaggio)ServiceList(messaggio)ServiceList.ServiceItem(messaggio)ServiceList.ServiceItem.FreeFormServiceItem(messaggio)ServiceList.ServiceItem.StructuredServiceItem(messaggio)ServiceType(messaggio)SpecialHourPeriod(messaggio)SpecialHours(messaggio)Spiciness(enum)StartUploadMediaItemDataRequest(messaggio)TimeInterval(messaggio)TimePeriod(messaggio)TimeRange(messaggio)TransferLocationRequest(messaggio)UpdateAccountAdminRequest(messaggio)UpdateAccountRequest(messaggio)UpdateFoodMenusRequest(messaggio)UpdateHealthProviderAttributesRequest(messaggio)UpdateLocalPostRequest(messaggio)UpdateLocationAdminRequest(messaggio)UpdateLocationRequest(messaggio)UpdateMediaItemRequest(messaggio)UpdateNotificationsRequest(messaggio)UpdateQuestionRequest(messaggio)UpdateReviewReplyRequest(messaggio)UpdateServiceListRequest(messaggio)UpsertAnswerRequest(messaggio)UrlAttributeValue(messaggio)ValidationError(messaggio)Verification(messaggio)Verification.VerificationState(enum)VerificationMethod(enum)VerificationOption(messaggio)VerificationOption.AddressVerificationData(messaggio)VerificationOption.EmailVerificationData(messaggio)VerificationOption.PhoneVerificationData(messaggio)VerifyLocationRequest(messaggio)VerifyLocationResponse(messaggio)
AccessControl
Questo servizio consente di gestire gli utenti che hanno accesso ad account e posizioni.
| AcceptInvitation | |
|---|---|
|
Accetta l'invito specificato.
|
|
| CreateAccountAdmin | |
|---|---|
|
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.
|
|
| CreateLocationAdmin | |
|---|---|
|
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.
|
|
| DeclineInvitation | |
|---|---|
|
Rifiuta l'invito specificato.
|
|
| DeleteAccountAdmin | |
|---|---|
|
Rimuove l'amministratore specificato dall'account specificato.
|
|
| DeleteLocationAdmin | |
|---|---|
|
Rimuove l'amministratore specificato come gestore della sede specificata.
|
|
| ListAccountAdmins | |
|---|---|
|
Elenca gli amministratori dell'account specificato.
|
|
| ListInvitations | |
|---|---|
|
Elenca gli inviti in attesa per l'account specificato.
|
|
| ListLocationAdmins | |
|---|---|
|
Elenca tutti gli amministratori per la sede specificata.
|
|
| UpdateAccountAdmin | |
|---|---|
|
Aggiorna l'amministratore per l'amministratore account specificato. È possibile aggiornare solo il ruolo Admin dell'amministratore.
|
|
| UpdateLocationAdmin | |
|---|---|
|
Aggiorna l'Amministratore per l'amministratore della località specificato. È possibile aggiornare solo il ruolo Admin dell'amministratore.
|
|
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
Accountrisorse, denominataaccounts/*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 | |
|---|---|
|
Crea un account con il nome e il tipo specificati sotto l'elemento principale specificato.
|
|
| DeleteNotifications | |
|---|---|
|
Cancella le impostazioni di notifica Pub/Sub per l'account.
|
|
| GenerateAccountNumber | |
|---|---|
|
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.
|
|
| GetAccount | |
|---|---|
|
Recupera l'account specificato. Restituisce
|
|
| GetNotifications | |
|---|---|
|
Restituisce le impostazioni di notifica Pub/Sub per l'account.
|
|
| ListAccounts | |
|---|---|
|
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.
|
|
| UpdateAccount | |
|---|---|
|
Aggiorna l'account aziendale specificato. Non è possibile aggiornare gli account personali con questo metodo.
|
|
| UpdateNotifications | |
|---|---|
|
Configura le impostazioni di notifica Pub/Sub per l'account per indicare a Profilo dell'attività per quale argomento inviare notifiche Pub/Sub:
Un account avrà una sola risorsa per le impostazioni di notifica ed è possibile impostare un solo argomento Pub/Sub.
|
|
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 | |
|---|---|
|
Restituisce un elenco di categorie di attività per la lingua e gli ID GConcept forniti.
|
|
| ListBusinessCategories | |
|---|---|
|
Restituisce un elenco di categorie di attività. La ricerca corrisponderà al nome della categoria, ma non all'ID della categoria.
|
|
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 | |
|---|---|
|
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.
|
|
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 | |
|---|---|
|
Restituisce i menu dei cibi di una località specifica. Chiamalo solo se location.location_state.can_have_food_menu è true.
|
|
| UpdateFoodMenus | |
|---|---|
|
Consente di aggiornare i menu dei cibi di una località specifica. Chiamalo solo se location.location_state.can_have_food_menu è true.
|
|
GoogleLocations
Questa API consente l'accesso e la ricerca in GoogleLocation.
| ListRecommendedGoogleLocations | |
|---|---|
|
Elenca tutti i 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.
|
|
| ReportGoogleLocation | |
|---|---|
|
Segnala un
|
|
| SearchGoogleLocations | |
|---|---|
|
Cerca tutte le possibili località corrispondenti alla richiesta specificata.
|
|
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 | |
|---|---|
|
Restituisce gli attributi del fornitore di servizi sanitari di una località specifica.
|
|
| UpdateHealthProviderAttributes | |
|---|---|
|
Aggiorna gli attributi del fornitore di servizi sanitari di una località specifica.
|
|
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 | |
|---|---|
|
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.
|
|
| ReportLocationInsights | |
|---|---|
|
Restituisce un report contenente approfondimenti su una o più metriche per località.
|
|
InsuranceNetworkService
Questo servizio consente di ottenere tutte le reti assicurative supportate per le sedi delle attività sanitarie su Google.
| ListInsuranceNetworks | |
|---|---|
|
Restituisce un elenco di tutte le reti di assicurazioni supportate da Google.
|
|
LocalPosts
Questa API espone l'API di gestione dei post locali.
| CreateLocalPost | |
|---|---|
|
Crea un nuovo post locale associato alla posizione specificata e lo restituisce.
|
|
| DeleteLocalPost | |
|---|---|
|
Elimina un post locale. Restituisce
|
|
| GetLocalPost | |
|---|---|
|
Recupera il post locale specificato. Restituisce
|
|
| ListLocalPosts | |
|---|---|
|
Restituisce un elenco di post locali associati a una posizione.
|
|
| UpdateLocalPost | |
|---|---|
|
Aggiorna il post locale specificato e restituisce il post locale aggiornato.
|
|
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
Accountrisorse, denominataaccounts/*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
Accountha una raccolta diLocationrisorse, denominataaccounts/*/locations/*
| AssociateLocation | |
|---|---|
|
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
|
|
| BatchGetLocations | |
|---|---|
|
Recupera tutte le località specificate nell'account specificato.
|
|
| ClearLocationAssociation | |
|---|---|
|
Cancella l'associazione tra una località e il relativo ID. Questa operazione è valida solo se la sede non è verificata.
|
|
| CreateLocation | |
|---|---|
|
Crea un nuovo
|
|
| DeleteLocation | |
|---|---|
|
Elimina una località. |
|
| FindMatchingLocations | |
|---|---|
|
Trova tutte le possibili località corrispondenti alla località specificata. Questa operazione è valida solo se la sede non è verificata.
|
|
| GetChain | |
|---|---|
|
Restituisce la catena specificata. Restituisce
|
|
| GetGoogleUpdatedLocation | |
|---|---|
|
Recupera la versione aggiornata da Google della località specificata. Restituisce
|
|
| GetLocation | |
|---|---|
|
Recupera la località specificata. Restituisce
|
|
| ListAttributeMetadata | |
|---|---|
|
Restituisce l'elenco degli attributi disponibili che sarebbero disponibili per una località con il paese e la categoria principali specificati.
|
|
| ListLocations | |
|---|---|
|
Elenca le località dell'account specificato.
|
|
| SearchChains | |
|---|---|
|
Cerca la catena in base al nome.
|
|
| TransferLocation | |
|---|---|
|
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.
|
|
| UpdateLocation | |
|---|---|
|
Aggiorna la località specificata. Le foto sono consentite soltanto in una sede che dispone di una pagina Google+. Restituisce
|
|
Media
Questo servizio consente la gestione dei contenuti multimediali (foto e video) collegati a una località.
| CreateMediaItem | |
|---|---|
|
Crea un nuovo elemento multimediale per la posizione.
|
|
| DeleteMediaItem | |
|---|---|
|
Elimina l'elemento multimediale specificato.
|
|
| GetCustomerMediaItem | |
|---|---|
|
Restituisce i metadati per l'elemento multimediale del cliente richiesto.
|
|
| GetMediaItem | |
|---|---|
|
Restituisce i metadati per l'elemento multimediale richiesto.
|
|
| ListCustomerMediaItems | |
|---|---|
|
Restituisce un elenco di elementi multimediali associati a una località che sono stati forniti dai clienti.
|
|
| ListMediaItems | |
|---|---|
|
Restituisce un elenco di elementi multimediali associati a una posizione.
|
|
| StartUploadMediaItemData | |
|---|---|
|
Genera un
|
|
| UpdateMediaItem | |
|---|---|
|
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.
|
|
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 | |
|---|---|
|
Aggiunge una domanda per la sede specificata.
|
|
| DeleteAnswer | |
|---|---|
|
Consente di eliminare la risposta scritta dall'utente corrente a una domanda.
|
|
| DeleteQuestion | |
|---|---|
|
Consente di eliminare una domanda specifica scritta dall'utente corrente.
|
|
| ListAnswers | |
|---|---|
|
Restituisce l'elenco impaginato di risposte per una domanda specifica.
|
|
| ListQuestions | |
|---|---|
|
Restituisce l'elenco impaginato delle domande e alcune delle relative risposte per una posizione specificata.
|
|
| UpdateQuestion | |
|---|---|
|
Aggiorna una domanda specifica scritta dall'utente corrente.
|
|
| UpsertAnswer | |
|---|---|
|
Crea una risposta o aggiorna la risposta esistente scritta dall'utente per la domanda specificata. Un utente può creare una sola risposta per domanda.
|
|
Recensioni
Questa API fornisce operazioni CRUD per le recensioni. google.mybusiness.v4.Reviews.
| BatchGetReviews | |
|---|---|
|
Restituisce l'elenco impaginato delle recensioni per tutte le sedi specificate. Questa operazione è valida solo se le località specificate sono verificate.
|
|
| DeleteReviewReply | |
|---|---|
|
Elimina la risposta alla recensione specificata. Questa operazione è valida solo se la località specificata è verificata.
|
|
| GetReview | |
|---|---|
|
Restituisce la recensione specificata. Questa operazione è valida solo se la località specificata è verificata. Restituisce
|
|
| ListReviews | |
|---|---|
|
Restituisce l'elenco impaginato delle recensioni per la sede specificata. Questa operazione è valida solo se la località specificata è verificata.
|
|
| UpdateReviewReply | |
|---|---|
|
Aggiorna la risposta alla recensione specificata. Viene creata una risposta se non ne esiste una. Questa operazione è valida solo se la località specificata è verificata.
|
|
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 | |
|---|---|
|
Recupera l'elenco di servizi specificato per una località.
|
|
| UpdateServiceList | |
|---|---|
|
Aggiorna l'elenco di servizi specificato di una posizione.
|
|
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 | |
|---|---|
|
Completa una verifica di È necessario solo per i metodi di verifica diversi da
|
|
| FetchVerificationOptions | |
|---|---|
|
Segnala tutte le opzioni di verifica idonee per una località in una lingua specifica.
|
|
| ListVerifications | |
|---|---|
|
Elenca le verifiche di una sede, ordinate in base all'ora di creazione.
|
|
| VerifyLocation | |
|---|---|
|
Avvia la procedura di verifica per una sede.
|
|
AcceptInvitationRequest
Messaggio di richiesta per AccessControl.AccettaInvito.
| Campi | |
|---|---|
name |
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 |
Il nome della risorsa, nel formato |
account_name |
Il nome dell'account. |
type |
Solo output. Specifica il valore |
role |
Solo output. Specifica il valore |
state |
Solo output. Indica il |
account_number |
Numero di riferimento dell'account, se fornito. |
permission_level |
Solo output. Specifica il valore |
organization_info |
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 |
Il dominio registrato per l'account. |
postal_address |
L'indirizzo postale dell'account. |
phone_number |
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 |
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 |
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 |
Nome del contatto a cui inviare la posta. |
Amministratore
| Campi | |
|---|---|
name |
Nome della risorsa. Per gli amministratori account, il formato è: Per gli amministratori delle sedi, il formato è: |
admin_name |
Il nome dell'amministratore. Quando si effettua l'invito iniziale, questo è l'indirizzo email dell'invitato. Per le chiamate |
role |
Specifica il valore |
pending_invitation |
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 |
Solo output. Nome univoco delle risposte accounts/*/locations/*/questions/*/answers/* |
author |
Solo output. L'autore della risposta. |
upvote_count |
Solo output. Il numero di voti positivi per la risposta. |
text |
Il testo della risposta. Deve contenere almeno uno spazio non vuoto. La lunghezza massima è di 4096 caratteri. |
create_time |
Solo output. Il timestamp in cui è stata scritta la risposta. |
update_time |
Solo output. Il timestamp relativo all'ultima modifica della risposta. |
AssociateLocationRequest
Messaggio di richiesta per locations.AssociateLocationRequest.
| Campi | |
|---|---|
name |
Il nome della risorsa della località da associare. |
place_id |
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 |
L'ID dell'attributo. Gli ID degli attributi sono forniti da Google. |
value_type |
Solo output. Il tipo di valore contenuto in questo attributo. Dovrebbe essere utilizzato per determinare come interpretare il valore. |
values[] |
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 |
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[] |
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 |
L'ID dell'attributo. |
value_type |
Il tipo di valore dell'attributo. I valori impostati e recuperati dovrebbero essere di questo tipo. |
display_name |
Il nome visualizzato localizzato dell'attributo, se disponibile. altrimenti il nome visualizzato in inglese. |
group_display_name |
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 |
Se true, l'attributo supporta più valori. Se false, è necessario fornire un solo valore. |
value_metadata[] |
Per alcuni tipi di attributi (ad esempio le enum), viene fornito un elenco di valori supportati e dei relativi nomi visualizzati. |
is_deprecated |
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 |
Il valore dell'attributo. |
display_name |
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 |
Il nome visualizzato dell'utente |
profile_photo_url |
L'URL della foto del profilo dell'utente. |
type |
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[] |
Una raccolta di metriche per cui restituire valori per includere le opzioni di restituzione dei dati. |
time_range |
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 |
BatchGetBusinessCategoriesRequest
Messaggio di richiesta per BusinessCategories.BatchGetBusinessCategories.
| Campi | |
|---|---|
language_code |
Obbligatorio. Il codice BCP 47 del linguaggio in cui devono essere restituiti i nomi delle categorie. |
category_ids[] |
Obbligatorio. Devi impostare almeno un nome. Gli ID di GConcept per i quali devono essere restituiti i nomi delle categorie localizzate. |
region_code |
(Facoltativo) Il codice paese ISO 3166-1 alpha-2 utilizzato per dedurre un linguaggio non standard. |
view |
Obbligatorio. Specifica le parti della risorsa Categoria da restituire nella risposta. |
BatchGetBusinessCategoriesResponse
Messaggio di risposta per BusinessCategories.BatchGetBusinessCategories.
| Campi | |
|---|---|
categories[] |
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 |
Il nome dell'account da cui recuperare le sedi. |
location_names[] |
Una raccolta di posizioni da recuperare, specificate dai loro nomi. |
BatchGetLocationsResponse
Messaggio di risposta per locations.BatchGetLocations.
| Campi | |
|---|---|
locations[] |
Un insieme di località. |
BatchGetReviewsRequest
Messaggio di richiesta per Reviews.BatchGetReviews.
| Campi | |
|---|---|
name |
Il nome dell'account da cui recuperare un elenco di recensioni in più sedi. |
location_names[] |
Una raccolta di sedi per cui recuperare le recensioni, specificate dai nomi. |
page_size |
Numero di recensioni da recuperare per pagina. Il valore predefinito è 50. |
page_token |
Se specificato, consente di recuperare la pagina successiva di recensioni. |
order_by |
(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 |
ignore_rating_only_reviews |
Indica se ignorare le recensioni con solo valutazioni. |
BatchGetReviewsResponse
Messaggio di risposta per Reviews.BatchGetReviews.
| Campi | |
|---|---|
location_reviews[] |
Recensioni con informazioni sulla posizione. |
next_page_token |
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[] |
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 |
Il tipo di azione che verrà eseguita. |
url |
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 |
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 |
di Google. Il nome leggibile della categoria. Viene impostato durante la lettura della posizione. Quando modifichi la località, è necessario impostare Nota: questo campo viene utilizzato solo nelle risposte. Qualsiasi valore specificato qui in una richiesta viene ignorato. |
category_id |
di Google. Un ID fisso (fornito da Google) per questa categoria. È necessario specificare Nota: questo campo viene utilizzato solo nelle risposte. Qualsiasi valore specificato qui in una richiesta viene ignorato. |
service_types[] |
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[] |
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 |
Il nome della risorsa della catena, nel formato |
chain_names[] |
Nomi della catena. |
websites[] |
Siti web della catena. |
location_count |
Numero di sedi che fanno parte di questa catena. |
ChainName
Nome da utilizzare durante la visualizzazione della catena.
| Campi | |
|---|---|
display_name |
Il nome visualizzato di questa catena. |
language_code |
Il codice BCP 47 della lingua del nome. |
ChainUrl
URL da utilizzare per la visualizzazione della catena.
| Campi | |
|---|---|
url |
L'URL di questa catena. |
ClearLocationAssociationRequest
Messaggio di richiesta per locations.ClearLocationAssociationRequest.
| Campi | |
|---|---|
name |
Il nome della risorsa della località di cui annullare l'associazione. |
CompleteVerificationRequest
Messaggio di richiesta per Verifications.CompleteVerifyAction.
| Campi | |
|---|---|
name |
Nome della risorsa della verifica da completare. |
pin |
Codice PIN ricevuto dal commerciante per completare la verifica. |
CompleteVerificationResponse
Messaggio di risposta relativo a Verifications.CompleteVerifyAction.
| Campi | |
|---|---|
verification |
La verifica è stata completata. |
CreateAccountAdminRequest
Messaggio di richiesta per AccessControl.CreateAccountAdmin.
| Campi | |
|---|---|
parent |
Il nome della risorsa dell'account per il quale è stato creato questo amministratore. |
admin |
L'amministratore che crea |
CreateAccountRequest
Messaggio di richiesta per Accounts.CreateAccount.
| Campi | |
|---|---|
primary_owner |
Il nome della risorsa dell'account che sarà il proprietario principale dell'account in fase di creazione. Deve avere il formato |
account |
Dati per l'account da creare. Gli unici campi consentiti sono account_name e type. |
CreateLocalPostRequest
Messaggio di richiesta per CreateLocalPost.
| Campi | |
|---|---|
parent |
Il nome della posizione in cui creare il post locale. |
local_post |
I nuovi metadati del post locale. |
CreateLocationAdminRequest
Messaggio di richiesta per AccessControl.CreateLocationAdmin.
| Campi | |
|---|---|
parent |
Il nome della risorsa della località per cui è stato creato questo amministratore. |
admin |
L'amministratore che crea |
CreateLocationRequest
Messaggio di richiesta per locations.CreateLocation.
| Campi | |
|---|---|
parent |
Il nome dell'account in cui creare la sede. |
location |
I nuovi metadati sulla posizione. |
validate_only |
Se true, la richiesta viene convalidata senza creare effettivamente la località. |
request_id |
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 |
Il nome della risorsa della posizione in cui verrà creato questo elemento multimediale. |
media_item |
L'elemento multimediale da creare. |
CreateQuestionRequest
Messaggio di richiesta per questionsAndAnswers.CreateQuestion
| Campi | |
|---|---|
parent |
Il nome del luogo per cui scrivere una domanda. |
question |
La nuova domanda. |
DeclineInvitationRequest
Messaggio di richiesta per AccessControl.RifiutaInvito.
| Campi | |
|---|---|
name |
Il nome dell'invito all'account che viene rifiutato. |
DeleteAccountAdminRequest
Messaggio di richiesta per AccessControl.DeleteAccountAdmin.
| Campi | |
|---|---|
name |
Il nome della risorsa dell'amministratore da rimuovere dall'account. |
DeleteAnswerRequest
Messaggio di richiesta per questionsAndAnswers.DeleteAnswer
| Campi | |
|---|---|
parent |
Il nome della domanda per cui eliminare una risposta. |
DeleteLocalPostRequest
Messaggio di richiesta per DeleteLocalPost.
| Campi | |
|---|---|
name |
Il nome del post locale da eliminare. |
DeleteLocationAdminRequest
Messaggio di richiesta per AccessControl.DeleteLocationAdmin.
| Campi | |
|---|---|
name |
Il nome della risorsa dell'amministratore da rimuovere dalla località. |
DeleteLocationRequest
Messaggio di richiesta per locations.DeleteLocation.
| Campi | |
|---|---|
name |
Il nome della località da eliminare. |
DeleteMediaItemRequest
Messaggio di richiesta per Media.DeleteMediaItem.
| Campi | |
|---|---|
name |
Il nome dell'elemento multimediale da eliminare. |
DeleteNotificationsRequest
Richiesta di un messaggio per Accounts.Deletenotifications.
| Campi | |
|---|---|
name |
Il nome della risorsa per le impostazioni di notifica da cancellare. |
DeleteQuestionRequest
Messaggio di richiesta per questionsAndAnswers.DeleteQuestion
| Campi | |
|---|---|
name |
Il nome della domanda da eliminare. |
DeleteReviewReplyRequest
Messaggio di richiesta per Reviews.DeleteReviewReview.
| Campi | |
|---|---|
name |
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 |
L'opzione che ha richiesto questo valore dimensionale. |
time_dimension |
La dimensione del valore. |
value |
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 |
Il giorno della settimana (da "MONDAY" a "SUNDAY") a cui corrisponde questo valore. Impostato per l'opzione BREAKDOWN_DAY_OF_WEEK. |
time_of_day |
L'ora del giorno (da 0 a 23) a cui corrisponde questo valore. Impostato per l'opzione BREAKDOWN_hour_OF_DAY. |
time_range |
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 |
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 |
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 |
Indirizzo email a cui inviare il PIN. Un indirizzo email viene accettato solo se è uno degli indirizzi forniti da FetchVerificaOptions. Se il parametro |
ErrorDetail
Indica in dettaglio un errore che ha generato una convalida o un errore interno.
| Campi | |
|---|---|
code |
Il codice di stato, che deve essere un valore enum pari a |
field |
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 |
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 |
Il valore che non ha soddisfatto la richiesta. |
field_index |
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 |
Nome risorsa della località da verificare. |
language_code |
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 |
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[] |
Le opzioni di verifica disponibili. |
FindMatchingLocationsRequest
Messaggio di richiesta per locations.FindMatchingLocations.
| Campi | |
|---|---|
name |
Il nome della risorsa della località per cui trovare corrispondenze. |
language_code |
La lingua preferita per la località corrispondente (nel formato BCP-47). |
num_results |
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 |
Deprecato. Questo campo viene ignorato per tutte le richieste. |
FindMatchingLocationsResponse
Messaggio di risposta per locations.FindMatchingLocations.
| Campi | |
|---|---|
matched_locations[] |
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 |
Data/ora dell'ultima esecuzione dell'algoritmo di corrispondenza per questa località. |
FollowersMetadata
Metadati dei follower per una località.
| Campi | |
|---|---|
name |
Nome della risorsa per questo elemento. accounts/{account_id}/locations/{location_id}/followers/metadata |
count |
Numero totale di follower per la località. |
FoodMenu
Menu di un'attività che serve piatti alimentari.
| Campi | |
|---|---|
labels[] |
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 |
(Facoltativo) URL di origine del menu se c'è una pagina web a cui andare. |
sections[] |
Obbligatorio. Sezioni del menu. |
cuisines[] |
(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[] |
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 |
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[] |
(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 |
Obbligatorio. Prezzo del piatto. |
spiciness |
(Facoltativo) Livello di piccantezza del piatto. |
allergen[] |
(Facoltativo) Allergeni associati al piatto alimentare. Ti consigliamo vivamente di fornire questo campo. |
dietary_restriction[] |
(Facoltativo) Informazioni sull'alimentazione del piatto. Ti consigliamo vivamente di fornire questo campo. |
nutrition_facts |
(Facoltativo) Dati nutrizionali dell'opzione del piatto. Ti consigliamo vivamente di fornire questo campo. |
ingredients[] |
(Facoltativo) Ingredienti dell'opzione per i piatti. |
serves_num_people |
(Facoltativo) Questo piatto indica il numero di persone che può essere servito. |
preparation_methods[] |
(Facoltativo) Metodi di preparazione del piatto. |
portion_size |
(Facoltativo) Dimensione dell'ordine, rappresentata in unità di articoli. (ad es. 4 "spiedini", 6 "pezzi") |
media_keys[] |
(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[] |
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 |
Obbligatorio. Numero della porzione. |
unit[] |
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[] |
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 |
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[] |
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[] |
Obbligatorio. Elementi della sezione. Ogni Sezione deve contenere almeno un elemento. |
FoodMenus
Menù di un'attività che serve piatti alimentari.
| Campi | |
|---|---|
name |
Obbligatorio. Identificatore Google di questa sede nel formato: |
menus[] |
(Facoltativo) Una raccolta di menù di cibo. |
GenerateAccountNumberRequest
Messaggio di richiesta per Accounts.GenerateAccountNumber.
| Campi | |
|---|---|
name |
Il nome dell'account per il quale generare un numero di conto bancario. |
GetAccountRequest
Messaggio di richiesta per Accounts.GetAccount.
| Campi | |
|---|---|
name |
Il nome dell'account da recuperare. |
GetChainRequest
Messaggio di richiesta per locations.GetChain.
| Campi | |
|---|---|
name |
Il nome della risorsa della catena, nel formato |
GetCustomerMediaItemRequest
Messaggio di richiesta per Media.GetCustomerMediaItem.
| Campi | |
|---|---|
name |
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 |
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 |
Obbligatorio. Identificatore Google di questa sede nel formato: |
read_mask |
(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 |
Obbligatorio. Identificatore Google di questa località nel formato: accounts/{account_id}/locations/{location_id}/healthProviderAttributes |
language_code |
(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 |
Il nome del post locale da recuperare. |
GetLocationRequest
Messaggio di richiesta per locations.GetLocation.
| Campi | |
|---|---|
name |
Il nome della posizione da recuperare. |
GetMediaItemRequest
Messaggio di richiesta per Media.GetMediaItem.
| Campi | |
|---|---|
name |
Il nome dell'elemento multimediale richiesto. |
GetNotificationsRequest
Richiesta di un messaggio per Accounts.Getnotifications.
| Campi | |
|---|---|
name |
Il nome della risorsa delle impostazioni di notifica. |
GetReviewRequest
Messaggio di richiesta per Reviews.GetReview.
| Campi | |
|---|---|
name |
Il nome della recensione da recuperare. |
GetServiceListRequest
Recupera il messaggio di richiesta dell'elenco dei servizi.
| Campi | |
|---|---|
name |
Obbligatorio. Identificatore Google di questa sede nel formato: |
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 |
Nome risorsa di questa posizione Google, nel formato |
location |
Informazioni su |
request_admin_rights_url |
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 |
La versione aggiornata da Google di questa località. |
diff_mask |
I campi aggiornati da Google. |
HealthProviderAttributes
Attributi del fornitore di servizi sanitari collegati a questa sede
| Campi | |
|---|---|
name |
Obbligatorio. Identificatore Google di questa sede nel formato: |
insurance_networks[] |
(Facoltativo) Un elenco delle reti di assicurazioni attive per questa località. |
InsuranceNetwork
Un'unica rete assicurativa. ID successivo: 5
| Campi | |
|---|---|
network_id |
Obbligatorio. L'ID di questa rete assicurativa generata da Google. |
network_names |
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 |
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 |
Solo output. Stato di questa rete assicurativa. |
InternalError
Descrive gli errori interni.
| Campi | |
|---|---|
error_details[] |
Descrive i singoli errori. |
Invito
Solo output. Rappresenta un invito in attesa.
| Campi | ||
|---|---|---|
name |
Il nome della risorsa per l'invito. |
|
role |
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 |
L'account con poche informazioni a cui è destinato questo invito. |
|
target_location |
La località di destinazione a cui è indirizzato l'invito. |
|
TargetLocation
Rappresenta una località di destinazione per un invito in attesa.
| Campi | |
|---|---|
location_name |
Il nome della sede alla quale l'utente è invitato. |
location_address |
L'indirizzo della sede alla quale l'utente è invitato. |
ListAccountAdminsRequest
Messaggio di richiesta per AccessControl.ListAccountAdmins.
| Campi | |
|---|---|
parent |
Il nome dell'account da cui recuperare un elenco di amministratori. |
ListAccountAdminsResponse
Messaggio di risposta per AccessControl.ListAccountAdmins.
| Campi | |
|---|---|
admins[] |
Una raccolta di istanze |
ListAccountsRequest
Messaggio di richiesta per Accounts.ListAccounts.
| Campi | |
|---|---|
page_size |
Il numero di account da recuperare per pagina. Il valore predefinito è 20, il minimo è 2 e la dimensione massima della pagina è 20. |
page_token |
Se specificato, viene recuperata la pagina degli account successiva. |
name |
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à |
filter |
Un filtro vincola gli account da restituire. La risposta include solo le voci che corrispondono al filtro. Se il campo Ad esempio, una richiesta con il filtro |
ListAccountsResponse
Messaggio di risposta per Accounts.ListAccounts.
| Campi | |
|---|---|
accounts[] |
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 |
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 |
ListAnswersRequest
Messaggio di richiesta per questionsAndAnswers.ListAnswers
| Campi | |
|---|---|
parent |
Il nome della domanda per cui recuperare le risposte. |
page_size |
Il numero di risposte da recuperare per pagina. I valori predefiniti e massimi di |
page_token |
Se specificata, viene recuperata la pagina successiva di risposte. |
order_by |
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[] |
Le risposte richieste. |
total_size |
Il numero totale di risposte pubblicate per questa domanda in tutte le pagine. |
next_page_token |
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 |
Nome della risorsa della località per cercare gli attributi disponibili. |
category_id |
L'ID stabile della categoria principale per trovare gli attributi disponibili. |
country |
Il codice paese ISO 3166-1 alpha-2 per trovare gli attributi disponibili. |
language_code |
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 |
Il numero di attributi da includere per pagina. Il valore predefinito è 200, il minimo è 1. |
page_token |
Se specificato, viene recuperata la pagina successiva dei metadati degli attributi. |
ListAttributeMetadataResponse
Messaggio di risposta per locations.ListAttributeMetadata.
| Campi | |
|---|---|
attributes[] |
Una raccolta di metadati degli attributi per gli attributi disponibili. |
next_page_token |
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 |
ListBusinessCategoriesRequest
| Campi | |
|---|---|
region_code |
Il codice paese ISO 3166-1 alpha-2. |
language_code |
Il codice del linguaggio BCP 47. Se la lingua non è disponibile, verrà utilizzata per impostazione predefinita l'inglese. |
search_term |
Stringa di filtro facoltativa dell'utente. |
page_size |
Quante categorie recuperare per pagina. Il valore predefinito è 100, il minimo è 1 e la dimensione massima della pagina è 100. |
page_token |
Se specificato, verrà recuperata la pagina successiva di categorie. |
view |
(Facoltativo) Specifica le parti della risorsa Categoria da restituire nella risposta. |
ListBusinessCategoriesResponse
| Campi | |
|---|---|
categories[] |
Le categorie. Le categorie sono visualizzazione DI BASE. Non contengono informazioni ServiceType. |
total_category_count |
Il numero totale di categorie per i parametri della richiesta. |
next_page_token |
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 |
ListCustomerMediaItemsRequest
Messaggio di richiesta per Media.ListCustomerMediaItems.
| Campi | |
|---|---|
parent |
Il nome della sede di cui verranno elencati gli elementi multimediali del cliente. |
page_size |
Il numero di elementi multimediali da restituire per pagina. Il valore predefinito è 100, mentre la dimensione massima supportata per la pagina è 200. |
page_token |
Se specificato, restituisce la pagina successiva di elementi multimediali. |
ListCustomerMediaItemsResponse
Messaggio di risposta per Media.ListCustomerMediaItems.
| Campi | |
|---|---|
media_items[] |
L'elenco di elementi multimediali restituito. |
total_media_item_count |
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 |
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 |
Obbligatorio. Il nome della località di cui verranno elencate le reti assicurative. Il nome è nel formato: accounts/{account_id}/locations/{location_id} |
language_code |
(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 |
Numero di reti di assicurazioni da restituire per pagina. Il valore predefinito è 5000. La dimensione massima della pagina è 10.000. |
page_token |
Se specificata, restituisce la pagina successiva delle reti di assicurazioni. |
ListInsuranceNetworksResponse
Messaggio di risposta per InsuranceNetworkService.ListInsuranceNetworks
| Campi | |
|---|---|
networks[] |
Un elenco di reti di assicurazioni supportate da Google. |
next_page_token |
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 |
Il nome dell'account da cui viene recuperato l'elenco degli inviti. |
target_type |
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[] |
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 |
Il nome della sede di cui verranno elencati i post locali. |
page_size |
Il numero di post locali da restituire per pagina. Il valore predefinito è 20. Il valore minimo è 1, mentre quello massimo è 100. |
page_token |
Se specificato, restituisce la pagina successiva di post locali. |
ListLocalPostsResponse
Messaggio di risposta per ListLocalPosts
| Campi | |
|---|---|
local_posts[] |
L'elenco di post locali restituito. |
next_page_token |
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 |
ListLocationAdminsRequest
Messaggio di richiesta per AccessControl.ListLocationAdmins.
| Campi | |
|---|---|
parent |
Il nome della sede di cui elencare gli amministratori. |
ListLocationAdminsResponse
Messaggio di risposta per AccessControl.ListLocationAdmins.
| Campi | |
|---|---|
admins[] |
Una raccolta di istanze |
ListLocationsRequest
Messaggio di richiesta per locations.ListLocations.
| Campi | |
|---|---|
parent |
Il nome dell'account da cui recuperare le posizioni. Se l' |
page_size |
Il numero di sedi da recuperare per pagina. Il valore predefinito è 100, il minimo è 1 e la dimensione massima della pagina è 100. |
page_token |
Se specificato, consente di recuperare le |
filter |
Un filtro vincola le località da restituire. La risposta include solo le voci che corrispondono al filtro. Se il campo Per ulteriori informazioni sui campi validi e sull'utilizzo di esempio, consulta la Guida all'utilizzo dei dati sulla posizione. |
language_code |
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 |
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[] |
Le località. |
next_page_token |
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 |
total_size |
Il numero approssimativo di località nell'elenco, indipendentemente dall'impaginazione. |
ListMediaItemsRequest
Messaggio di richiesta per Media.ListMediaItems.
| Campi | |
|---|---|
parent |
Il nome della posizione di cui verranno elencati gli elementi multimediali. |
page_size |
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 |
Se specificato, restituisce la pagina successiva di elementi multimediali. |
ListMediaItemsResponse
Messaggio di risposta per Media.ListMediaItems.
| Campi | |
|---|---|
media_items[] |
L'elenco di elementi multimediali restituito. |
total_media_item_count |
Il numero totale di elementi multimediali per questa posizione, indipendentemente dall'impaginazione. |
next_page_token |
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 |
Il nome del luogo per cui recuperare le domande. |
page_size |
Numero di domande da recuperare per pagina. I valori predefiniti e massimi di |
page_token |
Se specificata, viene recuperata la pagina successiva di domande. |
answers_per_question |
Quante risposte recuperare per domanda. I valori predefiniti e massimi di |
filter |
Un filtro vincola le domande da restituire. L'unico filtro attualmente supportato è "ignore_answered=true" |
order_by |
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[] |
Le domande richieste, |
total_size |
Il numero totale di domande pubblicate per questa località in tutte le pagine. |
next_page_token |
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 |
Nome della risorsa dell'account per cui recuperare le località Google consigliate. |
page_size |
Il numero di sedi da recuperare per pagina. Il valore predefinito è 25, il minimo è 1 e la dimensione massima della pagina è 100. |
page_token |
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[] |
Le località consigliate per un account Profilo dell'attività. Ciascuno di questi rappresenta un |
total_size |
Il numero totale di sedi consigliate per questo account Profilo dell'attività, indipendentemente dall'impaginazione. |
next_page_token |
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 |
Il nome della sede per cui recuperare le recensioni. |
page_size |
Numero di recensioni da recuperare per pagina. Il numero massimo di |
page_token |
Se specificato, consente di recuperare la pagina successiva di recensioni. |
order_by |
Specifica il campo in base al quale ordinare le recensioni. Se non viene specificato, l'ordine delle recensioni restituite verrà impostato sul valore predefinito |
ListReviewsResponse
Messaggio di risposta per Reviews.ListReviews.
| Campi | |
|---|---|
reviews[] |
Le recensioni. |
average_rating |
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 |
Il numero totale di recensioni per questa località. |
next_page_token |
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 |
Nome risorsa della località a cui appartengono le richieste di verifica. |
page_size |
Numero di verifiche da includere per pagina. Se non viene impostato, restituisce tutto. |
page_token |
Se specificato, restituisce la pagina successiva di verifiche. |
ListVerificationsResponse
Messaggio di risposta relativo a Verifications.ListVerifications.
| Campi | |
|---|---|
verifications[] |
Elenco delle verifiche. |
next_page_token |
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 |
Solo output. Identificatore Google per questo post locale nel modulo: |
language_code |
La lingua del post locale. |
summary |
Descrizione/corpo del post locale. |
call_to_action |
L'URL a cui vengono indirizzati gli utenti quando fanno clic sulla promozione. Ignorato per il tipo di argomento |
create_time |
Solo output. Ora di creazione del post. |
update_time |
Solo output. L'ora dell'ultima modifica del post effettuata dall'utente. |
event |
Informazioni sull'evento. Obbligatorio per i tipi di argomento |
state |
Solo output. Lo stato del post, che indica in quale parte del suo ciclo di vita si trova. |
media[] |
I contenuti multimediali associati al post. source_url è l'unico campo di dati supportato per un LocalPost MediaItem. |
search_url |
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 |
Obbligatorio. Il tipo di argomento del post: standard, evento, offerta o avviso. |
alert_type |
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 |
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 |
Nome dell'evento. |
schedule |
Data/ora di inizio e di fine dell'evento. |
LocalPostMetrics
Tutte le metriche richieste per un post locale.
| Campi | |
|---|---|
local_post_name |
|
metric_values[] |
Un elenco di valori per le metriche richieste. |
LocalPostOffer
Campi specifici per i post sulle offerte.
| Campi | |
|---|---|
coupon_code |
(Facoltativo) Codice offerta utilizzabile in negozio o online. |
redeem_online_url |
(Facoltativo) Link online per utilizzare l'offerta. |
terms_conditions |
(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 |
Identificatore Google di questa sede nel formato: Questo campo non verrà compilato. |
language_code |
La lingua del luogo. Impostato durante la creazione e non aggiornabile. |
store_code |
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 |
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 |
primary_phone |
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[] |
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 |
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 |
primary_category |
Categoria che descrive meglio l'attività principale in cui opera questa sede. |
additional_categories[] |
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 |
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 |
Orario di apertura dell'attività. |
special_hours |
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 |
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 |
Una raccolta di chiavi che collega questa attività ad altre proprietà di Google, come una pagina Google+ e Google Maps Places. |
labels[] |
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 |
Informazioni aggiuntive visualizzate in AdWords. |
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 |
open_info |
Un flag che indica se la sede è attualmente aperta. |
location_state |
Solo output. Un insieme di valori booleani che riflette lo stato di una località. |
attributes[] |
Attributi per questa località. |
metadata |
Solo output. Informazioni aggiuntive non modificabili dall'utente. |
price_lists[] |
Obsoleto: informazioni sul listino prezzi per questa località. |
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 |
Tutte le sedi e le catene correlate a questa. |
more_hours[] |
Altri orari per i diversi reparti o per clienti specifici di un'attività. |
Metadati
Ulteriori informazioni sulla località non modificabili dall'utente.
| Campi | |
|---|---|
duplicate |
Informazioni sulla sede duplicata da questa sede. Presente solo quando |
maps_url |
Un link alla posizione su Maps. |
new_review_url |
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 |
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 |
L'ID della località duplicata. |
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 |
Il nome della risorsa della catena di cui fa parte questa località. |
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 |
Il nome della risorsa località a cui appartiene questo valore della metrica. |
top_direction_sources[] |
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 |
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 |
I dati relativi al numero di giorni vengono aggregati. |
region_counts[] |
Regioni ordinate in ordine decrescente per conteggio. |
RegionCount
Una regione con il numero di richieste associato.
| Campi | |
|---|---|
latlng |
Centro della regione. |
label |
Etichetta leggibile per la regione. |
count |
Numero di richieste di indicazioni stradali da questa regione. |
LocationKey
Riferimenti chiave alternativi/surrogati per una località.
| Campi | |
|---|---|
plus_page_id |
Solo output. Se alla sede è associata una pagina Google+, viene inserito l'ID della pagina Google+ della sede in questione. |
place_id |
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 |
Solo output. Il valore true indica che l'ID luogo non impostato è intenzionale, diversamente da quando non è stata ancora effettuata alcuna associazione. |
request_id |
Solo output. |
LocationMetrics
Una serie di metriche e metriche di distribuzione associate a una località in un determinato intervallo di tempo.
| Campi | |
|---|---|
location_name |
Il nome della risorsa località a cui appartengono questi valori. |
time_zone |
Fuso orario IANA per la località. |
metric_values[] |
Un elenco di valori per le metriche richieste. |
LocationReview
Rappresenta una recensione con informazioni sulla posizione.
| Campi | |
|---|---|
name |
Nome risorsa posizione. |
review |
Una recensione per il luogo. |
LocationState
Contiene un insieme di valori booleani che riflettono lo stato di una località.
| Campi | |
|---|---|
is_google_updated |
Solo output. Indica se l'ID luogo associato a questa località è aggiornato. |
is_duplicate |
Solo output. Indica se la sede è un duplicato di un'altra. |
is_suspended |
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 |
Solo output. Indica se la posizione può essere aggiornata. |
can_delete |
Solo output. Indica se la sede può essere eliminata utilizzando l'API Google My Business. |
is_verified |
Solo output. Indica se la sede è verificata. |
needs_reverification |
Solo output. Indica se la sede richiede una nuova verifica. |
is_pending_review |
Solo output. Indica se la revisione della sede è in attesa. |
is_disabled |
Solo output. Indica se la posizione è disattivata. |
is_published |
Solo output. Indica se la località è pubblicata. |
is_disconnected |
Solo output. Indica se la sede è scollegata da un luogo su Google Maps. |
is_local_post_api_disabled |
Solo output. Indica se accounts.locations.localPosts è disattivato per questa sede. |
can_modify_service_list |
Solo output. Indica se l'elenco può modificare un ServiceList. |
can_have_food_menus |
Solo output. Indica se la scheda è idonea per il menù del cibo. |
has_pending_edits |
Solo output. Indica se una delle proprietà di questa località è in stato di modifica in attesa. |
has_pending_verification |
Solo output. Indica se la sede ha richieste di verifica in attesa. |
can_operate_health_data |
Solo output. Indica se la località può operare su dati sanitari. |
can_operate_lodging_data |
Solo output. Indica se la località può utilizzare i dati delle strutture ricettive. |
MatchedLocation
Rappresenta una possibile corrispondenza con una località.
| Campi | |
|---|---|
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 |
is_exact_match |
Si tratta di una corrispondenza esatta? |
MediaItem
Un singolo elemento multimediale.
| Campi | ||
|---|---|---|
name |
Il nome della risorsa per questo elemento multimediale. |
|
media_format |
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 |
Obbligatorio quando chiami Questa operazione è necessaria quando si aggiungono nuovi contenuti multimediali a una località con |
|
google_url |
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 |
Solo output. Se fornito, l'URL di un'immagine in miniatura per questo elemento multimediale. |
|
create_time |
Solo output. Ora di creazione di questo elemento multimediale. |
|
dimensions |
Solo output. Le dimensioni (larghezza e altezza) in pixel. |
|
insights |
Solo output. Statistiche per questo elemento multimediale. |
|
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 |
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 Ad eccezione delle categorie Tutte le foto caricate devono rispettare le linee guida di Profilo dell'attività per le foto. |
||
source_url |
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 Questo campo non può essere aggiornato. |
|
data_ref |
Solo input. Un riferimento ai dati binari degli elementi multimediali ottenuti con il metodo Quando crei un elemento multimediale,
o
è 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 |
Il nome utente a cui attribuire l'elemento multimediale. |
profile_photo_url |
URL della miniatura della foto del profilo dell'utente attribuito. |
takedown_url |
L'URL della pagina di rimozione, in cui l'elemento multimediale può essere segnalato se non è appropriato. |
profile_url |
L'URL della pagina del profilo Google Maps dell'utente attribuito. |
Dimensioni
Dimensioni dell'elemento multimediale.
| Campi | |
|---|---|
width_pixels |
Larghezza dell'elemento multimediale, in pixel. |
height_pixels |
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 |
La categoria a cui appartiene questa foto del luogo. |
|
price_list_item_id |
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. |
LOGO |
Foto del logo. |
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 |
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 |
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 Esempio di caricamento di byte: Per le chiamate |
MenuLabel
Etichetta da utilizzare per la visualizzazione del menu e dei suoi vari sottocomponenti.
| Campi | |
|---|---|
display_name |
Obbligatorio. Nome visualizzato del componente. |
description |
(Facoltativo) Informazioni supplementari sul componente. |
language_code |
(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. |
VIEWS_SEARCH |
Il numero di volte in cui la risorsa è stata visualizzata nella Ricerca Google. |
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 |
La metrica richiesta. |
options[] |
Come devono apparire i valori una volta restituiti. |
MetricValue
Un valore di una singola metrica da un'ora di inizio.
| Campi | |
|---|---|
metric |
La metrica per cui si applica il valore. |
total_value |
Il valore aggregato totale per questa metrica. Impostato per l'opzione AGGREGATED_TOTAL. |
dimensional_values[] |
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 |
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[] |
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 |
Solo output. Un ID stabile fornito da Google per questo tipo di orario. |
display_name |
Solo output. Il nome visualizzato in inglese leggibile per il tipo di orario. |
localized_display_name |
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 |
Solo output. Il nome della risorsa delle notifiche. |
topic_name |
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[] |
Tipi di notifiche che verranno inviate all'argomento Cloud Pub/Sub. È necessario specificarne almeno uno. Per interrompere completamente la ricezione delle notifiche, utilizza |
NutritionFacts
Questo messaggio rappresenta i valori nutrizionali di un piatto.
| Campi | |
|---|---|
calories |
(Facoltativo) Calorie del piatto. |
total_fat |
(Facoltativo) Informazioni sui grassi per un determinato piatto. |
cholesterol |
(Facoltativo) Informazioni sul colesterolo per un determinato piatto. |
sodium |
(Facoltativo) Informazioni sul sodio per un determinato piatto. |
total_carbohydrate |
(Facoltativo) Informazioni sui carboidrati per un determinato piatto. |
protein |
(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 |
Obbligatorio. Riduzione della quantità di calorie |
upper_amount |
(Facoltativo) Quantità superiore di calorie |
unit |
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 |
Obbligatorio. Minore quantità di alimentazione |
upper_amount |
(Facoltativo) Nutrizione superiore |
unit |
Obbligatorio. Unità delle informazioni nutrizionali fornite. |
OpenInfo
Informazioni relative allo stato di apertura dell'attività.
| Campi | |
|---|---|
status |
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 |
Solo output. Indica se questa attività è idonea alla riapertura. |
opening_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 |
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 |
Il nome localizzato del luogo. Ad esempio, |
place_id |
L'ID del luogo. Deve corrispondere a una regione. |
Luoghi
Definisce l'unione delle aree rappresentate da un insieme di luoghi.
| Campi | |
|---|---|
place_infos[] |
Le aree rappresentate dagli ID luogo. È consentito un massimo di 20 posti. |
PointRadius
Un raggio intorno a un punto specifico (latitudine/longitudine).
| Campi | |
|---|---|
latlng |
La latitudine/longitudine che specifica il centro di un'area definita dal raggio. |
radius_km |
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 |
Obbligatorio. ID del listino prezzi. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località. |
labels[] |
Obbligatorio. Etichette con tag di lingua per il listino prezzi. |
source_url |
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[] |
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 |
Obbligatorio. Nome visualizzato del listino prezzi, della sezione o dell'articolo. |
description |
(Facoltativo) Descrizione del listino prezzi, della sezione o dell'articolo. |
language_code |
(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 |
Obbligatorio. ID della sezione. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località. |
labels[] |
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 |
(Facoltativo) Tipo della sezione del listino prezzi corrente. Il valore predefinito è FOOD. |
items[] |
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 |
Obbligatorio. ID dell'articolo. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località. |
labels[] |
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 |
(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 |
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 |
Solo output. Il nome univoco della domanda. accounts/*/locations/*/questions/* |
author |
Solo output. L'autore della domanda. |
upvote_count |
Solo output. Il numero di voti positivi per la domanda. |
text |
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 |
Solo output. Il timestamp in cui è stata scritta la domanda. |
update_time |
Solo output. Il timestamp relativo all'ultima modifica della domanda. |
top_answers[] |
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 |
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[] |
Valori enum impostati. |
unset_values[] |
Valori enum non impostati. |
ReportGoogleLocationRequest
Messaggio di richiesta per la segnalazione di un GoogleLocation.
| Campi | ||
|---|---|---|
name |
Nome risorsa di [GoogleLocation], nel formato |
|
location_group_name |
(Facoltativo) Il nome della risorsa del gruppo di località per cui viene segnalata questa località Google, nel formato |
|
report_reason_elaboration |
(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 |
(Facoltativo) Codice del linguaggio BCP 47 utilizzato in |
|
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 |
Il motivo per cui l'utente segnala questa posizione quando il problema riguarda la località stessa. |
|
report_reason_bad_recommendation |
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 |
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 Deve essere accompagnato da un |
IRRELEVANT |
La località consigliata non è pertinente per l'utente. Deve essere accompagnata da un |
ReportLocalPostInsightsRequest
Messaggio di richiesta per Insights.ReportLocalPostInsights
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della sede per la quale recuperare gli approfondimenti. |
local_post_names[] |
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 |
basic_request |
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 |
|
local_post_metrics[] |
Una voce per post richiesto corrispondente a questa località. |
time_zone |
Fuso orario (ID fuso orario IANA, ad es. "Europa/Londra") della località. |
ReportLocationInsightsRequest
Messaggio di richiesta per Insights.ReportLocationInsights.
| Campi | |
|---|---|
name |
Il nome della risorsa dell'account. |
location_names[] |
Una raccolta di località per cui recuperare gli insight, specificate dai nomi. |
basic_request |
Una richiesta per includere nel report informazioni sulle metriche di base. |
driving_directions_request |
Una richiesta per includere nel report informazioni sulle richieste di indicazioni stradali. |
ReportLocationInsightsResponse
Messaggio di risposta per Insights.ReportLocationInsights.
| Campi | |
|---|---|
location_metrics[] |
Una raccolta di valori di metriche per località. |
location_driving_direction_metrics[] |
Una raccolta di valori per le metriche relative alle indicazioni stradali. |
Rivedi
Solo output. Rappresenta la recensione di una località.
| Campi | |
|---|---|
name |
Nome della risorsa. Per la revisione ha il formato |
review_id |
L'identificatore univoco criptato. |
reviewer |
L'autore della recensione. |
star_rating |
La valutazione a stelle della recensione. |
comment |
Corpo della recensione come testo normale con markup. |
create_time |
Il timestamp di quando è stata scritta la recensione. |
update_time |
Il timestamp relativo all'ultima modifica della recensione. |
review_reply |
Risposta del proprietario/gestore di questa sede a questa recensione. |
Autore recensione
Rappresenta l'autore della recensione.
| Campi | |
|---|---|
profile_photo_url |
Il link alla foto del profilo del recensore. Compilato solo se |
display_name |
Il nome del recensore. Compilato con il nome reale del recensore solo se |
is_anonymous |
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 |
Il corpo della risposta come testo normale con i markup. La lunghezza massima è 4096 byte. |
update_time |
Solo output. Il timestamp relativo all'ultima modifica della risposta. |
SearchChainsRequest
Messaggio di richiesta per locations.SearchChains.
| Campi | |
|---|---|
chain_display_name |
Cerca una catena in base al nome. Sono supportate le query esatte/parziali/fuzzy/correlate. Esempi: "walmart", "wal-mart", "walmmmart", "沃尔玛" |
result_count |
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[] |
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 |
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 |
Località da cercare. Se fornite, troveranno le sedi che corrispondono ai dettagli della sede forniti. |
|
query |
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[] |
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 |
Indica il |
|
Campo unione coverageArea. Indica l'area di copertura in cui l'attività offre il servizio. coverageArea può essere solo uno dei seguenti: |
||
radius |
Solo output. L'area servita dall'attività commerciale intorno a un punto. |
|
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 |
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 |
Obbligatorio. Identificatore Google di questa sede nel formato: |
service_items[] |
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 |
(Facoltativo) Questo campo consente di stabilire se il servizio di immissione è offerto o meno dal commerciante. |
|
price |
(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 |
Questo campo verrà impostato in caso di dati di servizi strutturati. |
|
free_form_service_item |
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 |
Obbligatorio. |
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 |
Obbligatorio. Il campo |
description |
(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 |
Solo output. Un ID stabile (fornito da Google) per questo tipo di servizio. |
display_name |
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 |
La data di calendario in cui inizia questo periodo di un'ora speciale. |
open_time |
Il tempo effettivo su |
end_date |
La data di calendario di questo periodo di un'ora speciale. Se il campo |
close_time |
Il tempo totale di esecuzione su |
is_closed |
Se true, |
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[] |
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 |
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 |
La data di inizio del periodo. |
start_time |
L'ora di inizio del periodo. |
end_date |
La data di fine del periodo. |
end_time |
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 |
Indica il valore |
open_time |
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 |
Indica il valore |
close_time |
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 dell'inizio dell'intervallo (incluso). |
end_time |
Timestamp per la fine dell'intervallo (escluso). |
TransferLocationRequest
Messaggio di richiesta per locations.TransferLocation.
| Campi | |
|---|---|
name |
Il nome della sede da trasferire. |
to_account |
Nome della risorsa dell'account in cui trasferire la località (ad esempio "accounts/8675309"). |
UpdateAccountAdminRequest
Messaggio di richiesta per AccessControl.UpdateAccountAdmin.
| Campi | |
|---|---|
name |
Il nome della risorsa dell'amministratore da aggiornare. |
admin |
L'amministratore aggiornato. Nota: l'unico campo modificabile è |
UpdateAccountRequest
Messaggio di richiesta per Accounts.UpdateAccount.
| Campi | |
|---|---|
name |
Il nome dell'account da aggiornare. |
account |
I dati dell'account aggiornati. Nota: l'unico campo modificabile è |
validate_only |
Se true, la richiesta viene convalidata senza aggiornare effettivamente l'account. |
UpdateFoodMenusRequest
Messaggio di richiesta per FoodMenu.UpdateFoodMenus
| Campi | |
|---|---|
food_menus |
Obbligatorio. Le informazioni aggiornate del menu alimentare. Puoi annullare l'impostazione del menu eseguendo l'aggiornamento senza sezioni del menu. |
update_mask |
(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 |
Obbligatorio. Attributi del fornitore di servizi sanitari aggiornati. |
update_mask |
(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 |
Il nome del post locale da aggiornare. |
local_post |
Le informazioni sui post locali aggiornate. |
update_mask |
I campi specifici da aggiornare. È necessario specificare ogni campo che viene aggiornato nella maschera. |
UpdateLocationAdminRequest
Messaggio di richiesta per AccessControl.UpdateLocationAdmin.
| Campi | |
|---|---|
name |
Il nome della risorsa dell'amministratore da aggiornare. |
admin |
L'amministratore aggiornato. Nota: l'unico campo modificabile è |
UpdateLocationRequest
Messaggio di richiesta per locations.UpdateLocation.
| Campi | |
|---|---|
name |
Il nome della sede da aggiornare. |
location |
Le informazioni sulla posizione aggiornate. |
update_mask |
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 |
Se true, la richiesta viene convalidata senza aggiornare effettivamente la località. |
attribute_mask |
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 |
Il nome dell'elemento multimediale da aggiornare. |
media_item |
L'elemento multimediale da aggiornare. È possibile aggiornare solo l'ID articolo della categoria o del listino prezzi. |
update_mask |
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 |
Il nome della risorsa delle impostazioni di notifica. |
notifications |
Le impostazioni di notifica aggiornate. |
UpdateQuestionRequest
Messaggio di richiesta per questionsAndAnswers.UpdateQuestion
| Campi | |
|---|---|
name |
Il nome della domanda da aggiornare. |
question |
La domanda aggiornata. |
UpdateReviewReplyRequest
Messaggio di richiesta per Reviews.UpdateReviewReview.
| Campi | |
|---|---|
name |
Il nome della recensione a cui rispondere. |
review_reply |
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 |
(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 |
(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 |
Il nome della domanda per cui scrivere una risposta. |
answer |
La nuova risposta. |
UrlAttributeValue
Valori per un attributo con un value_type di URL.
| Campi | |
|---|---|
url |
L'URL. |
ValidationError
Descrive gli errori di convalida in una richiesta del client.
| Campi | |
|---|---|
error_details[] |
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 |
Nome risorsa della verifica. |
method |
Il metodo di verifica. |
state |
Lo stato della verifica. |
create_time |
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 |
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 |
Impostalo solo se il metodo è PHONE_CALL o SMS. |
|
address_data |
Da impostare solo se il metodo è MAIL. |
|
email_data |
Impostalo solo se il metodo è EMAIL. |
|
AddressVerificationData
Mostra i dati per le verifiche tramite cartolina.
| Campi | |
|---|---|
business_name |
Nome dell'attività del commerciante. |
address |
Indirizzo a cui è possibile inviare una cartolina. |
EmailVerificationData
Mostra i dati per le verifiche via email.
| Campi | |
|---|---|
domain_name |
Nome di dominio nell'indirizzo email. ad es. "gmail.com" in foo@gmail.com |
user_name |
Nome utente nell'indirizzo email. ad es. "foo" in foo@gmail.com |
is_user_name_editable |
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 |
Numero di telefono a cui verrà inviato il PIN. |
VerifyLocationRequest
Messaggio di richiesta per Verifications.VerifyLocation.
| Campi | ||
|---|---|---|
name |
Nome risorsa della località da verificare. |
|
method |
Metodo di verifica. |
|
language_code |
Il codice lingua BCP 47 che rappresenta la lingua da utilizzare per la procedura di verifica. |
|
context |
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 |
Il valore inserito per il metodo EMAIL. |
|
address_input |
Input per il metodo ADDRESS. |
|
phone_input |
Input per il metodo PHONE_CALL/SMS |
|
VerifyLocationResponse
Messaggio di risposta relativo a Verifications.VerifyLocation.
| Campi | |
|---|---|
verification |
La richiesta di verifica creata. |