Indice
AccountIssueService
(interfaccia)AccountsService
(interfaccia)AutofeedSettingsService
(interfaccia)BusinessIdentityService
(interfaccia)BusinessInfoService
(interfaccia)EmailPreferencesService
(interfaccia)HomepageService
(interfaccia)OnlineReturnPolicyService
(interfaccia)ProgramsService
(interfaccia)RegionsService
(interfaccia)ShippingSettingsService
(interfaccia)TermsOfServiceAgreementStateService
(interfaccia)TermsOfServiceService
(interfaccia)UserService
(interfaccia)AcceptTermsOfServiceRequest
(messaggio)Accepted
(messaggio)AccessRight
(enum)Account
(messaggio)AccountAggregation
(messaggio)AccountIssue
(messaggio)AccountIssue.ImpactedDestination
(messaggio)AccountIssue.ImpactedDestination.Impact
(messaggio)AccountIssue.Severity
(enum)Address
(messaggio)AutofeedSettings
(messaggio)BusinessDayConfig
(messaggio)BusinessDayConfig.Weekday
(enum)BusinessIdentity
(messaggio)BusinessIdentity.IdentityAttribute
(messaggio)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(enum)BusinessIdentity.PromotionsConsent
(enum)BusinessInfo
(messaggio)CarrierRate
(messaggio)ClaimHomepageRequest
(messaggio)CreateAndConfigureAccountRequest
(messaggio)CreateAndConfigureAccountRequest.AddAccountService
(messaggio)CreateAndConfigureAccountRequest.AddUser
(messaggio)CreateRegionRequest
(messaggio)CreateUserRequest
(messaggio)CustomerService
(messaggio)CutoffTime
(messaggio)DeleteAccountRequest
(messaggio)DeleteRegionRequest
(messaggio)DeleteUserRequest
(messaggio)DeliveryTime
(messaggio)DisableProgramRequest
(messaggio)Distance
(messaggio)Distance.Unit
(enum)EmailPreferences
(messaggio)EmailPreferences.OptInState
(enum)EnableProgramRequest
(messaggio)GetAccountRequest
(messaggio)GetAutofeedSettingsRequest
(messaggio)GetBusinessIdentityRequest
(messaggio)GetBusinessInfoRequest
(messaggio)GetEmailPreferencesRequest
(messaggio)GetHomepageRequest
(messaggio)GetOnlineReturnPolicyRequest
(messaggio)GetProgramRequest
(messaggio)GetRegionRequest
(messaggio)GetShippingSettingsRequest
(messaggio)GetTermsOfServiceAgreementStateRequest
(messaggio)GetTermsOfServiceRequest
(messaggio)GetUserRequest
(messaggio)Headers
(messaggio)Homepage
(messaggio)InsertShippingSettingsRequest
(messaggio)ListAccountIssuesRequest
(messaggio)ListAccountIssuesResponse
(messaggio)ListAccountsRequest
(messaggio)ListAccountsResponse
(messaggio)ListOnlineReturnPoliciesRequest
(messaggio)ListOnlineReturnPoliciesResponse
(messaggio)ListProgramsRequest
(messaggio)ListProgramsResponse
(messaggio)ListRegionsRequest
(messaggio)ListRegionsResponse
(messaggio)ListSubAccountsRequest
(messaggio)ListSubAccountsResponse
(messaggio)ListUsersRequest
(messaggio)ListUsersResponse
(messaggio)LocationIdSet
(messaggio)MinimumOrderValueTable
(messaggio)MinimumOrderValueTable.StoreCodeSetWithMov
(messaggio)OnlineReturnPolicy
(messaggio)OnlineReturnPolicy.ItemCondition
(enum)OnlineReturnPolicy.Policy
(messaggio)OnlineReturnPolicy.Policy.Type
(enum)OnlineReturnPolicy.RestockingFee
(messaggio)OnlineReturnPolicy.ReturnMethod
(enum)OnlineReturnPolicy.ReturnShippingFee
(messaggio)OnlineReturnPolicy.ReturnShippingFee.Type
(enum)OnlineReturnPolicy.SeasonalOverride
(messaggio)PhoneVerificationState
(enum)Program
(messaggio)Program.Requirement
(messaggio)Program.State
(enum)RateGroup
(messaggio)Region
(messaggio)Region.GeoTargetArea
(messaggio)Region.PostalCodeArea
(messaggio)Region.PostalCodeArea.PostalCodeRange
(messaggio)Required
(messaggio)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(messaggio)RetrieveLatestTermsOfServiceRequest
(messaggio)Row
(messaggio)Service
(messaggio)Service.LoyaltyProgram
(messaggio)Service.LoyaltyProgram.LoyaltyProgramTiers
(messaggio)Service.ShipmentType
(enum)Service.StoreConfig
(messaggio)Service.StoreConfig.CutoffConfig
(messaggio)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(messaggio)Service.StoreConfig.StoreServiceType
(enum)ShippingSettings
(messaggio)Table
(messaggio)TermsOfService
(messaggio)TermsOfServiceAgreementState
(messaggio)TermsOfServiceKind
(enum)TransitTable
(messaggio)TransitTable.TransitTimeRow
(messaggio)TransitTable.TransitTimeRow.TransitTimeValue
(messaggio)UnclaimHomepageRequest
(messaggio)UpdateAccountRequest
(messaggio)UpdateAutofeedSettingsRequest
(messaggio)UpdateBusinessIdentityRequest
(messaggio)UpdateBusinessInfoRequest
(messaggio)UpdateEmailPreferencesRequest
(messaggio)UpdateHomepageRequest
(messaggio)UpdateRegionRequest
(messaggio)UpdateUserRequest
(messaggio)User
(messaggio)User.State
(enum)Value
(messaggio)Warehouse
(messaggio)WarehouseBasedDeliveryTime
(messaggio)WarehouseCutoffTime
(messaggio)
AccountIssueService
Servizio per supportare l'API AccountIssueService
.
ListAccountIssues |
---|
Elenca tutti i problemi dell'account di un account Merchant Center.
|
AccountsService
Servizio per supportare l'API Accounts.
CreateAndConfigureAccount |
---|
Crea un account Merchant Center autonomo con una configurazione aggiuntiva. Aggiunge l'utente che effettua la richiesta come amministratore del nuovo account.
|
DeleteAccount |
---|
Consente di eliminare l'account specificato, indipendentemente dal tipo: indipendente, AMC o subaccount. L'eliminazione di un AMC comporta l'eliminazione di tutti i relativi subaccount. L'esecuzione di questo metodo richiede l'accesso amministrativo. L'eliminazione va a buon fine solo se l'account non fornisce servizi ad altri account e non ha offerte elaborate. Puoi utilizzare il parametro
|
GetAccount |
---|
Recupera un account dal tuo account Merchant Center. Dopo aver inserito, aggiornato o eliminato un account, potrebbero essere necessari diversi minuti prima che le modifiche vengano applicate.
|
ListAccounts |
---|
Elenca gli account accessibili all'utente che chiama e che corrispondono ai vincoli della richiesta, ad esempio le dimensioni della pagina o i filtri. Non vengono elencati solo i subaccount di un AMC, ma tutti gli account a cui l'utente che chiama ha accesso, inclusi altri AMC, account collegati, account indipendenti e così via. Se non viene fornito alcun filtro, vengono restituiti gli account a cui l'utente è aggiunto direttamente. Questo metodo è eventualmente coerente, il che significa che modifiche come la creazione, l'aggiornamento di un account o la modifica delle relazioni tra gli account potrebbero non essere visualizzate immediatamente nei risultati. Queste modifiche vengono invece propagate in un breve periodo di tempo, dopodiché le informazioni aggiornate possono corrispondere ai predicati associati. Ciò significa che la ricerca per nome dell'account potrebbe non restituire un account modificato di recente anche se soddisfa il predicato.
|
ListSubAccounts |
---|
Elenca tutti i subaccount di un determinato account multi-cliente. Si tratta di un wrapper pratico per il metodo
|
UpdateAccount |
---|
Aggiorna un account indipendentemente dal tipo: indipendente, AMC o subaccount. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
AutofeedSettingsService
Servizio per supportare l'impostazione feed automatico.
GetAutofeedSettings |
---|
Recupera le impostazioni del feed automatico di un account.
|
UpdateAutofeedSettings |
---|
Aggiorna le impostazioni del feed automatico di un account.
|
BusinessIdentityService
Servizio per supportare l'API Business Identity.
GetBusinessIdentity |
---|
Recupera l'identità dell'attività di un account.
|
UpdateBusinessIdentity |
---|
Aggiorna l'identità dell'attività di un account. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
BusinessInfoService
Servizio per supportare l'API di informazioni sull'attività.
GetBusinessInfo |
---|
Recupera le informazioni sull'attività di un account.
|
UpdateBusinessInfo |
---|
Aggiorna le informazioni sull'attività di un account. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
EmailPreferencesService
Servizio per supportare l'API EmailPreferences
.
GetEmailPreferences |
---|
Restituisce le preferenze email di un utente dell'account Merchant Center. Questo servizio consente solo di recuperare e aggiornare le preferenze email per l'utente autenticato. Utilizza l'alias name=accounts/*/users/me/emailPreferences per ottenere le preferenze per l'utente autenticato.
|
UpdateEmailPreferences |
---|
Aggiorna le preferenze email di un utente dell'account Merchant Center. Gli utenti dell'AMC devono specificare l'account AMC anziché un subaccount dell'AMC. Le preferenze non selezionate esplicitamente nella maschera di aggiornamento non verranno aggiornate. Non è valido specificare un valore di stato di attivazione UNCONFIRMED per gli aggiornamenti. Utilizza l'alias name=accounts/*/users/me/emailPreferences per aggiornare le preferenze per l'utente autenticato.
|
HomepageService
Servizio per supportare un'API per la home page di un negozio.
ClaimHomepage |
---|
Rivendica la home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo. Se la home page è già stata rivendicata, la verifica verrà riesaminata (a meno che il commerciante non sia esente dalla rivendicazione, il che comporta anche l'esenzione dalla verifica) e verrà restituita una risposta positiva. Se la proprietà non può più essere verificata, verrà restituito un errore, ma la rivendicazione non verrà cancellata. In caso di errore, verrà restituito un messaggio di errore canonico: * PERMISSION_DENIED: l'utente non dispone delle autorizzazioni necessarie per questo account MC; * FAILED_PRECONDITION: - L'account non è un account Merchant Center; - L'account MC non ha una home page; - Claiming failed (in this case the error message will contain more details) (Claiming failed (in questo caso il messaggio di errore conterrà ulteriori dettagli)).
|
GetHomepage |
---|
Recupera la home page di un negozio.
|
UnclaimHomepage |
---|
Annullare la rivendicazione della home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
UpdateHomepage |
---|
Aggiorna la home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
OnlineReturnPolicyService
Il servizio semplifica la gestione della configurazione delle norme sui resi per ripensamento del commerciante, che includono le norme sui resi sia per gli annunci sia per le schede senza costi
programmi. Questa API definisce il seguente modello di risorse:
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
Recupera le norme sui resi esistenti per un determinato commerciante.
|
ListOnlineReturnPolicies |
---|
Elenca tutte le norme sui resi esistenti per un determinato commerciante.
|
ProgramsService
Servizio per la gestione del programma.
I programmi forniscono un meccanismo per aggiungere funzionalità agli account commerciante. Un esempio tipico è il programma Schede di prodotto senza costi, che consente di mostrare i prodotti del negozio di un commerciante senza costi su Google.
Questo servizio espone metodi per recuperare la partecipazione di un commerciante a tutti i programmi disponibili, oltre a metodi per attivare o disattivare esplicitamente la partecipazione a ciascun programma.
DisableProgram |
---|
Disattivare la partecipazione al programma specificato per l'account. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
EnableProgram |
---|
Attivare la partecipazione al programma specificato per l'account. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
GetProgram |
---|
Recupera il programma specificato per l'account.
|
ListPrograms |
---|
Recupera tutti i programmi per l'account.
|
RegionsService
Gestisce la configurazione delle regioni.
Questa API definisce il seguente modello di risorse:
Region
CreateRegion |
---|
Crea una definizione di regione nel tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
DeleteRegion |
---|
Consente di eliminare una definizione di regione dal tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
GetRegion |
---|
Recupera una regione definita nel tuo account Merchant Center.
|
ListRegions |
---|
Elenca le regioni nel tuo account Merchant Center.
|
UpdateRegion |
---|
Aggiorna una definizione di regione nel tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
ShippingSettingsService
Servizio per ottenere informazioni sulle impostazioni di spedizione delle chiamate ai metodi per ogni metodo dell'API Merchant.
GetShippingSettings |
---|
Recupera le informazioni sulle impostazioni di spedizione.
|
InsertShippingSettings |
---|
Sostituisci l'impostazione di spedizione di un commerciante con l'impostazione di richiesta di spedizione. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
TermsOfServiceAgreementStateService
Servizio per supportare l'API TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Restituisce lo stato di un contratto con Termini di servizio.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
Recupera lo stato del contratto per i Termini di servizio dell'applicazione.
|
TermsOfServiceService
Servizio per supportare l'API TermsOfService
.
AcceptTermsOfService |
---|
Accetta un
|
GetTermsOfService |
---|
Recupera il
|
RetrieveLatestTermsOfService |
---|
Recupera la versione più recente del
|
UserService
Servizio per supportare l'API utente.
CreateUser |
---|
Crea un utente dell'account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
DeleteUser |
---|
Consente di eliminare un utente dell'account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo. L'utente da eliminare non può essere l'ultimo utente amministratore dell'account. Inoltre, un utente è protetto dall'eliminazione se è gestito da Business Manager"
|
GetUser |
---|
Recupera un utente dell'account Merchant Center.
|
ListUsers |
---|
Elenca tutti gli utenti di un account Merchant Center.
|
Aggiorna utente |
---|
Aggiorna un utente dell'account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
AcceptTermsOfServiceRequest
Messaggio di richiesta per il metodo AcceptTermsOfService
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa della versione dei Termini di servizio. Formato: |
account |
Obbligatorio. L'account per cui accettare i TdS. |
region_ |
Obbligatorio. Codice regione come definito da CLDR. Si tratta di un paese quando i TdS si applicano specificamente a quel paese o di 001 quando si applicano a livello globale. |
Accettato
Descrive i Termini di servizio accettati.
Campi | |
---|---|
terms_ |
I termsOfService accettati. |
accepted_ |
L'account in cui è stata registrata l'accettazione. Può trattarsi dell'account stesso o, nel caso dei subaccount, dell'account AMC. |
valid_ |
Se impostato, indica che i TermsOfService accettati sono validi solo fino alla fine di questa data (in UTC). Prima di questa data, dovrai accettarne uno nuovo. Le informazioni relative a TermsOfService obbligatorie sono riportate nel messaggio Obbligatorio. |
AccessRight
Il diritto di accesso.
Enum | |
---|---|
ACCESS_RIGHT_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
STANDARD |
Diritti di accesso standard. |
ADMIN |
Diritti di accesso amministrativo. |
PERFORMANCE_REPORTING |
Gli utenti con questo diritto hanno accesso a rendimento e approfondimenti. |
Account
Il messaggio Account
rappresenta l'account di un commerciante negli annunci Shopping. È l'entità principale per la gestione dei dati di prodotto, delle impostazioni e delle interazioni con i servizi di Google e i fornitori esterni.
Gli account possono operare come entità autonome o far parte di una struttura di account multi-cliente (AMC). In una configurazione AMC, l'account principale gestisce più subaccount.
La creazione di un account prevede la configurazione di attributi come il nome dell'account, il fuso orario e le preferenze relative alla lingua.
Il messaggio Account
è l'entità principale di molte altre risorse, ad esempio AccountRelationship
, Homepage
, BusinessInfo
e così via.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa dell'account. Formato: |
account_ |
Solo output. L'ID dell'account. |
account_ |
Obbligatorio. Un nome leggibile dell'account. Per ulteriori informazioni, consulta nome del negozio e nome dell'attività. |
adult_ |
Indica se l'account include contenuti per adulti. |
test_ |
Solo output. Indica se si tratta di un account di prova. |
time_ |
Obbligatorio. Il fuso orario dell'account. Durante le scritture, Per le letture, |
language_ |
Obbligatorio. Il codice lingua BCP-47 dell'account, ad esempio |
AccountAggregation
Questo tipo non contiene campi.
AccountAggregation
payload.
AccountIssue
Un AccountIssue
.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa del problema dell'account. Formato: |
title |
Il titolo localizzato del problema. |
severity |
La gravità complessiva del problema. |
impacted_ |
L'impatto di questo problema sulle varie destinazioni. |
detail |
Ulteriori dettagli localizzati sul problema. |
documentation_ |
Link al Centro assistenza Merchant Center che fornisce ulteriori informazioni sul problema e su come risolverlo. |
ImpactedDestination
L'impatto del problema su una destinazione.
Campi | |
---|---|
impacts[] |
L'impatto (negativo) per varie regioni sulla destinazione specificata. |
reporting_ |
Il contesto dei report interessato. |
Impatto
L'impatto del problema su una regione.
Campi | |
---|---|
region_ |
Il codice regione CLDR a cui si applica il problema. |
severity |
La gravità del problema nella destinazione e nella regione. |
Gravità
Tutte le possibili gravità dei problemi.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
La gravità è sconosciuta. |
CRITICAL |
Il problema causa la mancata pubblicazione delle offerte. |
ERROR |
Il problema potrebbe interessare le offerte (in futuro) o essere un indicatore di problemi con le offerte. |
SUGGESTION |
Il problema è un suggerimento per il miglioramento. |
Indirizzo
Indirizzo di spedizione del magazzino.
Campi | |
---|---|
street_ |
La parte dell'indirizzo a livello di strada. Ad esempio: |
city |
Obbligatorio. Città, paese o comune. Può includere anche località o sottolocalità dipendenti (ad esempio quartieri o sobborghi). |
administrative_ |
Obbligatorio. Suddivisione amministrativa di primo livello del paese. Ad esempio, uno stato come la California ("CA") o una provincia come il Québec ("QC"). |
postal_ |
Obbligatorio. Codice postale (ad es. "94043"). |
region_ |
Obbligatorio. Codice paese CLDR (ad es. "US"). |
AutofeedSettings
Raccolta di informazioni relative alle impostazioni del feed automatico.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa delle impostazioni del feed automatico. Formato: |
enable_ |
Obbligatorio. Attiva o disattiva la scansione dei prodotti tramite il feed automatico per l'account specificato. Gli account feed automatico devono soddisfare determinate condizioni, che possono essere verificate tramite il campo |
eligible |
Solo output. Determina se il commerciante è idoneo alla registrazione a un feed automatico. |
BusinessDayConfig
Giorni lavorativi del magazzino.
Campi | |
---|---|
business_ |
Obbligatorio. Giorni lavorativi regolari. Non può essere vuoto. |
Giorno feriale
Enum | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
BusinessIdentity
Raccolta di informazioni relative all'identità di un'attività.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa dell'identità dell'attività. Formato: |
promotions_ |
Obbligatorio. Indica se gli attributi identità possono essere utilizzati per le promozioni. |
black_ |
Facoltativo. Specifica se l'attività si identifica come di proprietà di persone di colore. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
women_ |
Facoltativo. Specifica se l'attività si identifica come di proprietà di donne. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
veteran_ |
Facoltativo. Specifica se l'attività si identifica come di proprietà di veterani di guerra. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
latino_ |
Facoltativo. Specifica se l'attività si identifica come di proprietà di latinoamericani. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
small_ |
Facoltativo. Specifica se l'attività si identifica come piccola impresa. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
IdentityAttribute
Tutte le informazioni relative a un attributo identità.
Campi | |
---|---|
identity_ |
Obbligatorio. La dichiarazione di identità per questo attributo. |
IdentityDeclaration
Tutte le impostazioni possibili relative alla dichiarazione di un'identità.
Enum | |
---|---|
IDENTITY_DECLARATION_UNSPECIFIED |
Valore predefinito che indica che non è stata effettuata alcuna selezione. |
SELF_IDENTIFIES_AS |
Indica che l'account si identifica con l'attributo. |
DOES_NOT_SELF_IDENTIFY_AS |
Indica che l'account non è identificato dall'attributo. |
PromotionsConsent
Tutte le impostazioni possibili relative alle promozioni correlate all'identità dell'attività.
Enum | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
Valore predefinito che indica che non è stata effettuata alcuna selezione. |
PROMOTIONS_CONSENT_GIVEN |
Indica che l'account ha acconsentito all'utilizzo della propria identità aziendale per le promozioni. |
PROMOTIONS_CONSENT_DENIED |
Indica che l'account non ha dato il consenso all'utilizzo della sua identità aziendale per le promozioni. |
BusinessInfo
Il messaggio BusinessInfo
contiene informazioni essenziali sull'attività di un commerciante.
Questo messaggio acquisisce i dettagli chiave dell'attività, come indirizzo fisico, contatti dell'assistenza clienti e identificatori specifici per regione.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa delle informazioni sull'attività. Formato: |
address |
Facoltativo. L'indirizzo dell'attività. Sono supportati solo i campi |
phone |
Solo output. Il numero di telefono dell'attività. |
phone_ |
Solo output. Lo stato della verifica telefonica dell'attività. |
customer_ |
Facoltativo. L'assistenza clienti dell'attività. |
korean_ |
Facoltativo. Il numero di registrazione dell'attività per la Corea del Sud di 10 cifre separato da trattini nel formato: XXX-XX-XXXXX. |
CarrierRate
Un elenco di tariffe dell'operatore a cui è possibile fare riferimento tramite main_table
o single_value
. I servizi di corrieri supportati sono definiti in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
Campi | |
---|---|
name |
Obbligatorio. Nome della tariffa del corriere. Deve essere univoco per ogni gruppo di tariffe. |
carrier |
Obbligatorio. Servizio dell'operatore, ad esempio |
carrier_ |
Obbligatorio. Servizio dell'operatore, ad esempio |
origin_ |
Obbligatorio. Origine della spedizione per questa tariffa del corriere. |
percentage_ |
Facoltativo. Modificatore della tariffa di spedizione moltiplicativo come numero in notazione decimale. Può essere negativo. Ad esempio, |
flat_ |
Facoltativo. Modificatore della tariffa di spedizione additiva. Può essere negativo. Ad esempio, |
ClaimHomepageRequest
Messaggio di richiesta per il metodo ClaimHomepage
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della home page da rivendicare. Formato: |
overwrite |
Facoltativo. Se impostata su |
CreateAndConfigureAccountRequest
Messaggio di richiesta per il metodo CreateAndConfigureAccount
.
Campi | |
---|---|
account |
Obbligatorio. L'account da creare. |
users[] |
Facoltativo. Utenti da aggiungere all'account. Questo campo è deprecato e non esisterà dopo l'uscita dalla versione beta dell'API. Utilizza invece il campo |
user[] |
Facoltativo. Utenti da aggiungere all'account. |
service[] |
Obbligatorio. Nell'ambito della creazione viene inizializzato un servizio account tra l'account da creare e l'account del provider. È necessario fornire almeno un servizio di questo tipo. Al momento, è necessario che esattamente uno di questi valori sia |
AddAccountService
Istruzioni aggiuntive per aggiungere i servizi dell'account durante la creazione dell'account.
Campi | |
---|---|
Campo unione service_type . Il tipo di servizio da aggiungere. service_type può essere solo uno dei seguenti: |
|
account_ |
Il fornitore è un aggregatore per l'account. Payload per il tipo di servizio Aggregazione account. |
provider |
Obbligatorio. Il fornitore del servizio. Il riferimento a un account come |
AddUser
Istruzioni per aggiungere un utente all'account durante la creazione.
Campi | |
---|---|
user_ |
Obbligatorio. L'indirizzo email dell'utente (ad esempio |
user |
Facoltativo. Dettagli sull'utente da aggiungere. Al momento, è possibile specificare solo i diritti di accesso. |
CreateRegionRequest
Messaggio di richiesta per il metodo CreateRegion
.
Campi | |
---|---|
parent |
Obbligatorio. L'account per cui creare una regione. Formato: |
region_ |
Obbligatorio. L'identificatore della regione, univoco per tutte le regioni dello stesso account. |
region |
Obbligatorio. La regione da creare. |
CreateUserRequest
Messaggio di richiesta per il metodo CreateUser
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa dell'account per cui verrà creato un utente. Formato: |
user_ |
Obbligatorio. L'indirizzo email dell'utente (ad esempio |
user |
Facoltativo. L'utente da creare. |
CustomerService
Informazioni sull'assistenza clienti.
Campi | |
---|---|
uri |
Facoltativo. L'URI in cui è possibile trovare l'assistenza clienti. |
email |
Facoltativo. L'indirizzo email a cui è possibile contattare l'assistenza clienti. |
phone |
Facoltativo. Il numero di telefono a cui è possibile chiamare l'assistenza clienti. |
CutoffTime
Definizione dell'ora limite dei giorni lavorativi.
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato nello stesso giorno. |
minute |
Obbligatorio. Minuto dell'orario limite entro il quale deve essere effettuato un ordine per consentirne l'elaborazione nello stesso giorno. |
time_ |
Obbligatorio. Identificatore del fuso orario, ad esempio "Europe/Zurich". |
DeleteAccountRequest
Messaggio di richiesta per il metodo DeleteAccount
.
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'account da eliminare. Formato: |
force |
Facoltativo. Se impostato su |
DeleteRegionRequest
Messaggio di richiesta per il metodo DeleteRegion
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della regione da eliminare. Formato: |
DeleteUserRequest
Messaggio di richiesta per il metodo DeleteUser
.
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'utente da eliminare. Formato: È anche possibile eliminare l'utente corrispondente all'utente che chiama utilizzando |
DeliveryTime
Tempo impiegato per vari aspetti, dall'ordine alla consegna del prodotto.
Campi | |
---|---|
warehouse_ |
Facoltativo. Indica che il tempo di consegna deve essere calcolato in base al magazzino (località di partenza della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non deve essere impostato nessun altro campo relativo al tempo di transito in [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
min_ |
Numero minimo di giorni lavorativi di transito. 0 indica la consegna in giornata, 1 indica la consegna il giorno successivo. È necessario impostare |
max_ |
Numero massimo di giorni lavorativi di transito. 0 indica la consegna in giornata, 1 indica la consegna il giorno successivo. Deve essere maggiore o uguale a |
cutoff_ |
Definizione dell'ora limite dei giorni lavorativi. Se non è configurato, l'ora di interruzione sarà impostata su 08:00 PST. |
min_ |
Numero minimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 indica la spedizione in giornata, 1 indica la spedizione il giorno successivo. "min_handling_days" e "max_handling_days" devono essere impostati o non impostati contemporaneamente. |
max_ |
Numero massimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 indica la spedizione in giornata, 1 indica la spedizione il giorno successivo. Deve essere maggiore o uguale a |
transit_ |
Tabella del tempo di transito, numero di giorni lavorativi trascorsi in transito in base alle dimensioni di riga e colonna. Puoi impostare |
handling_ |
I giorni lavorativi durante i quali è possibile gestire gli ordini. Se non viene fornito, si presume che i giorni lavorativi siano da lunedì a venerdì. |
transit_ |
I giorni lavorativi durante i quali gli ordini possono essere in transito. Se non viene fornito, si presume che i giorni lavorativi siano da lunedì a venerdì. |
DisableProgramRequest
Messaggio di richiesta per il metodo DisableProgram.
Campi | |
---|---|
name |
Obbligatorio. Il nome del programma per cui disattivare la partecipazione per l'account specificato. Formato: |
Distanza
Raggio di consegna massimo. Questo è necessario solo per il tipo di spedizione con consegna locale.
Campi | |
---|---|
value |
Valore intero della distanza. |
unit |
L'unità può variare in base al paese ed è parametrizzata in modo da includere miglia e chilometri. |
Unità
L'unità può variare in base al paese ed è parametrizzata per includere miglia e chilometri.
Enum | |
---|---|
UNIT_UNSPECIFIED |
Unità non specificata |
MILES |
Unità in miglia |
KILOMETERS |
Unità in chilometri |
EmailPreferences
Le categorie di notifiche attivate / disattivate dall'utente. Le preferenze email non includono gli annunci obbligatori, in quanto gli utenti non possono disattivarli.
Campi | |
---|---|
name |
Identificatore. Il nome di EmailPreferences. L'endpoint è supportato solo per l'utente autenticato. |
news_ |
Facoltativo. Aggiornamenti su nuove funzionalità, suggerimenti e best practice. |
OptInState
Stato di attivazione della preferenza email.
Enum | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
Lo stato di attivazione non è specificato. |
OPTED_OUT |
L'utente ha disattivato la ricezione di questo tipo di email. |
OPTED_IN |
L'utente ha attivato la ricezione di questo tipo di email. |
UNCONFIRMED |
L'utente ha attivato la ricezione di questo tipo di email e l'email di conferma è stata inviata, ma l'utente non ha ancora confermato l'attivazione (si applica solo a determinati paesi). |
EnableProgramRequest
Messaggio di richiesta per il metodo EnableProgram.
Campi | |
---|---|
name |
Obbligatorio. Il nome del programma per cui attivare la partecipazione per l'account specificato. Formato: |
GetAccountRequest
Messaggio di richiesta per il metodo GetAccount
.
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'account da recuperare. Formato: |
GetAutofeedSettingsRequest
Messaggio di richiesta per il metodo GetAutofeedSettings
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa delle impostazioni del feed automatico. Formato: |
GetBusinessIdentityRequest
Messaggio di richiesta per il metodo GetBusinessIdentity
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa dell'identità dell'attività. Formato: |
GetBusinessInfoRequest
Messaggio di richiesta per il metodo GetBusinessInfo
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa delle informazioni sull'attività. Formato: |
GetEmailPreferencesRequest
Messaggio di richiesta per il metodo GetEmailPreferences.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa |
GetHomepageRequest
Messaggio di richiesta per il metodo GetHomepage
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della home page da recuperare. Formato: |
GetOnlineReturnPolicyRequest
Messaggio di richiesta per il metodo GetOnlineReturnPolicy
.
Campi | |
---|---|
name |
Obbligatorio. Il nome delle norme sui resi da recuperare. Formato: |
GetProgramRequest
Messaggio di richiesta per il metodo GetProgram.
Campi | |
---|---|
name |
Obbligatorio. Il nome del programma da recuperare. Formato: |
GetRegionRequest
Messaggio di richiesta per il metodo GetRegion
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della regione da recuperare. Formato: |
GetShippingSettingsRequest
Messaggio di richiesta per il metodo GetShippingSetting
.
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'impostazione di spedizione da recuperare. Formato: |
GetTermsOfServiceAgreementStateRequest
Messaggio di richiesta per il metodo GetTermsOfServiceAgreementState
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa della versione dei Termini di servizio. Formato: |
GetTermsOfServiceRequest
Messaggio di richiesta per il metodo GetTermsOfService
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa della versione dei Termini di servizio. Formato: |
GetUserRequest
Messaggio di richiesta per il metodo GetUser
.
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'utente da recuperare. Formato: È anche possibile recuperare l'utente corrispondente all'utente chiamante utilizzando |
Intestazioni
Un elenco non vuoto di intestazioni di riga o colonna per una tabella. Deve essere impostato esattamente uno dei valori prices
, weights
, num_items
, postal_code_group_names
o location
.
Campi | |
---|---|
prices[] |
Obbligatorio. Un elenco di limiti superiori del prezzo dell'ordine inclusi. Il valore dell'ultimo prezzo può essere infinito impostando price amount_micros = -1. Ad esempio, |
weights[] |
Obbligatorio. Un elenco di limiti superiori del peso dell'ordine inclusivi. Il valore dell'ultimo peso può essere infinito impostando price amount_micros = -1. Ad esempio, |
number_ |
Obbligatorio. Un elenco di limiti superiori inclusivi del numero di articoli. L'ultimo valore può essere |
postal_ |
Obbligatorio. Un elenco di nomi di gruppi postali. L'ultimo valore può essere |
locations[] |
Obbligatorio. Un elenco di insiemi di ID posizione. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi. |
Home page
Il messaggio Homepage
rappresenta la home page del negozio di un commerciante all'interno del sistema.
La home page di un commerciante è il dominio principale in cui i clienti interagiscono con il suo negozio.
La home page può essere rivendicata e verificata come prova della proprietà e consente al commerciante di sbloccare le funzionalità che richiedono un sito web verificato. Per saperne di più, consulta Informazioni sulla verifica dell'URL del negozio online.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della home page del negozio. Formato: |
claimed |
Solo output. Indica se la home page è rivendicata. Vedi https://support.google.com/merchants/answer/176793. |
uri |
Obbligatorio. L'URI (in genere un URL) della home page del negozio. |
InsertShippingSettingsRequest
Messaggio di richiesta per il metodo InsertShippingSetting
.
Campi | |
---|---|
parent |
Obbligatorio. L'account in cui verrà inserito questo prodotto. Formato: accounts/{account} |
shipping_ |
Obbligatorio. La nuova versione dell'account. |
ListAccountIssuesRequest
Messaggio di richiesta per il metodo ListAccountIssues
.
Campi | |
---|---|
parent |
Obbligatorio. L'elemento principale, proprietario di questa raccolta di problemi. Formato: |
page_ |
Facoltativo. Il numero massimo di problemi da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituiti al massimo 50 utenti. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100 |
page_ |
Facoltativo. Un token di pagina ricevuto da una chiamata Quando viene applicata la paginazione, tutti gli altri parametri forniti a |
language_ |
Facoltativo. I problemi nella risposta avranno campi leggibili nella lingua specificata. Il formato è BCP-47, ad esempio |
time_ |
Facoltativo. Il fuso orario IANA utilizzato per localizzare le ore in campi leggibili. Ad esempio "America/Los_Angeles". Se non viene impostato, verrà utilizzato "America/Los_Angeles". |
ListAccountIssuesResponse
Messaggio di risposta per il metodo ListAccountIssues
.
Campi | |
---|---|
account_ |
I problemi dell'account specificato. |
next_ |
Un token che può essere inviato come |
ListAccountsRequest
Messaggio di richiesta per il metodo ListAccounts
.
Campi | |
---|---|
page_ |
Facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, vengono restituiti al massimo 250 account. Il valore massimo è 500; i valori superiori a 500 vengono forzati a 500. |
page_ |
Facoltativo. Un token di pagina ricevuto da una chiamata Quando viene applicata la paginazione, tutti gli altri parametri forniti a |
filter |
Facoltativo. Restituisce solo gli account che corrispondono al filtro. Per ulteriori dettagli, consulta la documentazione di riferimento sulla sintassi dei filtri. |
ListAccountsResponse
Messaggio di risposta per il metodo ListAccounts
.
Campi | |
---|---|
accounts[] |
Gli account corrispondenti a |
next_ |
Un token che può essere inviato come |
ListOnlineReturnPoliciesRequest
Messaggio di richiesta per il metodo ListOnlineReturnPolicies
.
Campi | |
---|---|
parent |
Obbligatorio. L'account commerciante per cui elencare le norme sui resi. Formato: |
page_ |
Facoltativo. Il numero massimo di risorse |
page_ |
Facoltativo. Un token di pagina ricevuto da una chiamata Quando viene applicata la paginazione, tutti gli altri parametri forniti a |
ListOnlineReturnPoliciesResponse
Messaggio di risposta per il metodo ListOnlineReturnPolicies
.
Campi | |
---|---|
online_ |
Le norme sui resi recuperate. |
next_ |
Un token che può essere inviato come |
ListProgramsRequest
Messaggio di richiesta per il metodo ListPrograms.
Campi | |
---|---|
parent |
Obbligatorio. Il nome dell'account per cui recuperare tutti i programmi. Formato: |
page_ |
Facoltativo. Il numero massimo di programmi da restituire in una singola risposta. Se non specificato (o 0), viene utilizzata una dimensione predefinita di 1000. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. |
page_ |
Facoltativo. Un token di continuazione ricevuto da una chiamata |
ListProgramsResponse
Messaggio di risposta per il metodo ListPrograms.
Campi | |
---|---|
programs[] |
I programmi per l'account specificato. |
next_ |
Un token che può essere inviato come |
ListRegionsRequest
Messaggio di richiesta per il metodo ListRegions
.
Campi | |
---|---|
parent |
Obbligatorio. L'account per cui elencare le regioni. Formato: |
page_ |
Facoltativo. Il numero massimo di regioni da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituite al massimo 50 regioni. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. |
page_ |
Facoltativo. Un token di pagina ricevuto da una chiamata Quando viene applicata la paginazione, tutti gli altri parametri forniti a |
ListRegionsResponse
Messaggio di risposta per il metodo ListRegions
.
Campi | |
---|---|
regions[] |
Le regioni del commerciante specificato. |
next_ |
Un token che può essere inviato come |
ListSubAccountsRequest
Messaggio di richiesta per il metodo ListSubAccounts
.
Campi | |
---|---|
provider |
Obbligatorio. Il fornitore di servizi di aggregazione. Formato: |
page_ |
Facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, vengono restituiti al massimo 250 account. Il valore massimo è 500; i valori superiori a 500 vengono forzati a 500. |
page_ |
Facoltativo. Un token di pagina ricevuto da una chiamata Quando viene applicata la paginazione, tutti gli altri parametri forniti a |
ListSubAccountsResponse
Messaggio di risposta per il metodo ListSubAccounts
.
Campi | |
---|---|
accounts[] |
Gli account per i quali l'account genitore specificato è un aggregatore. |
next_ |
Un token che può essere inviato come |
ListUsersRequest
Messaggio di richiesta per il metodo ListUsers
.
Campi | |
---|---|
parent |
Obbligatorio. Il gruppo principale, proprietario di questa raccolta di utenti. Formato: |
page_ |
Facoltativo. Il numero massimo di utenti da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituiti al massimo 50 utenti. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100 |
page_ |
Facoltativo. Un token di pagina ricevuto da una chiamata Quando viene applicata la paginazione, tutti gli altri parametri forniti a |
ListUsersResponse
Messaggio di risposta per il metodo ListUsers
.
Campi | |
---|---|
users[] |
Gli utenti dell'account specificato. |
next_ |
Un token che può essere inviato come |
LocationIdSet
Un elenco di insiemi di ID posizione. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi.
Campi | |
---|---|
location_ |
Obbligatorio. Un elenco non vuoto di ID posizione. Devono essere tutti dello stesso tipo di località (ad esempio stato). |
MinimumOrderValueTable
Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini con ritiro in negozio.
Campi | |
---|---|
store_ |
Obbligatorio. Un elenco di insiemi di codici identificativi del negozio che condividono lo stesso valore minimo dell'ordine. Sono necessari almeno due insiemi e l'ultimo deve essere vuoto, il che significa "MOV per tutti gli altri negozi". Ogni codice negozio può essere visualizzato una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. |
StoreCodeSetWithMov
Un elenco di set di codici negozio che condividono lo stesso valore minimo dell'ordine. Sono necessari almeno due insiemi e l'ultimo deve essere vuoto, il che significa "MOV per tutti gli altri negozi". Ogni codice negozio può essere visualizzato una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta.
Campi | |
---|---|
store_ |
Facoltativo. Un elenco di codici negozio univoci o vuoto per il valore generico. |
value |
Il valore minimo dell'ordine per i negozi specificati. |
OnlineReturnPolicy
Oggetto Norme sui resi online. Attualmente viene utilizzato per rappresentare le norme sui resi per i programmi di annunci e schede senza costi.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa |
return_ |
Solo output. ID delle norme sui resi generato da Google. |
label |
Obbligatorio. Immutabile. Questo campo rappresenta l'etichetta univoca definita dall'utente delle norme sui resi. È importante notare che la stessa etichetta non può essere utilizzata in norme sui resi diverse per lo stesso paese. A meno che un prodotto non specifichi un attributo etichetta specifico, i criteri verranno etichettati automaticamente come "predefiniti". Per assegnare norme sui resi personalizzate a determinati gruppi di prodotti, segui le istruzioni riportate nella sezione Etichetta delle norme sui resi. L'etichetta può contenere fino a 50 caratteri. |
countries[] |
Obbligatorio. Immutabile. I paesi di vendita in cui si applicano le norme sui resi. I valori devono essere un codice ISO 3166 di due lettere valido. |
policy |
Le norme sui resi. |
seasonal_ |
Facoltativo. Sostituzione dei criteri generali per gli ordini effettuati durante un insieme specifico di intervalli di tempo. |
restocking_ |
La commissione di riassortimento che si applica a tutte le categorie di motivi del reso. Se il valore non è impostato, verrà trattata come una tariffa di riassortimento senza costi. |
return_ |
I metodi di reso a disposizione dei clienti per restituire un articolo. Questo valore non deve essere vuoto, a meno che il tipo di norme sui resi non sia noReturns. |
item_ |
Le condizioni dell'articolo accettate per i resi non devono essere vuote, a meno che il tipo di norme sui resi non sia "noReturns". |
return_ |
La tariffa di spedizione del reso. Deve essere impostato solo quando il cliente deve scaricare e stampare l'etichetta di reso. |
return_ |
Obbligatorio. L'URI delle norme sui resi. Google può utilizzarlo per eseguire un controllo di congruità delle norme. Deve essere un URL valido. |
accept_ |
Questo campo specifica se il commerciante accetta solo i prodotti con problemi per i resi ed è obbligatorio. |
process_ |
Il campo specifica il numero di giorni necessari ai commercianti per elaborare i rimborsi. È facoltativo. |
accept_ |
Questo campo specifica se il commerciante consente ai clienti di cambiare i prodotti. È obbligatorio. |
ItemCondition
Le condizioni degli articoli disponibili.
Enum | |
---|---|
ITEM_CONDITION_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
NEW |
Nuovo. |
USED |
Usato. |
Norme
I criteri disponibili.
Campi | |
---|---|
type |
Tipo di criterio. |
days |
Il numero di giorni entro cui è possibile restituire gli articoli dopo la consegna, dove un giorno è definito come 24 ore dopo il timestamp della consegna. Obbligatorio per i resi di |
Tipo
Tipi di norme sui resi.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
NUMBER_OF_DAYS_AFTER_DELIVERY |
Il numero di giorni entro i quali un reso è valido dopo la consegna. |
NO_RETURNS |
Nessun reso. |
LIFETIME_RETURNS |
Resi illimitati. |
RestockingFee
La commissione di riassortimento. Può trattarsi di una tariffa fissa o di una micropercentuale.
Campi | |
---|---|
Campo unione
|
|
fixed_ |
Commissione di riassortimento fissa. |
micro_ |
Percentuale del prezzo totale in micro. 15.000.000 significa che verrà addebitato il 15% del prezzo totale. |
ReturnMethod
I metodi di reso disponibili.
Enum | |
---|---|
RETURN_METHOD_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
BY_MAIL |
Restituire il dispositivo per posta. |
IN_STORE |
Restituire l'articolo in negozio. |
AT_A_KIOSK |
Restituire il dispositivo presso un chiosco. |
ReturnShippingFee
La tariffa di spedizione del reso. Può essere una tariffa fissa o un valore booleano per indicare che il cliente paga il costo di spedizione effettivo.
Campi | |
---|---|
type |
Obbligatorio. Tipo di tariffa di spedizione reso. |
fixed_ |
Importo fisso della tariffa di spedizione del reso. Questo valore è applicabile solo quando il tipo è |
Tipo
Tipi di tariffe di spedizione reso.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
FIXED |
La tariffa di spedizione del reso è un valore fisso. |
CUSTOMER_PAYING_ACTUAL_FEE |
I clienti pagheranno la tariffa di spedizione del reso effettiva. |
SeasonalOverride
Avanti: 5
Campi | |
---|---|
label |
Obbligatorio. Nome visualizzato di questa sostituzione stagionale in Merchant Center. |
begin |
Obbligatorio. Definisce l'intervallo di date in cui si applica questa sostituzione stagionale. Sia inizio che fine sono inclusi e devono essere in formato decimale della data, ad esempio 20250115. Le date delle sostituzioni stagionali non devono sovrapporsi. |
end |
Obbligatorio. Data di fine della variazione stagionale (inclusa). |
policy |
Obbligatorio. Le norme sui resi per l'intervallo di date specificato. |
PhoneVerificationState
Lo stato della verifica telefonica.
Enum | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
PHONE_VERIFICATION_STATE_VERIFIED |
Lo smartphone è verificato. |
PHONE_VERIFICATION_STATE_UNVERIFIED |
Lo smartphone non è verificato |
Programma
Definisce la partecipazione a un determinato programma per l'account specificato.
I programmi forniscono un meccanismo per aggiungere funzionalità agli account commerciante. Un esempio tipico è il programma Schede di prodotto senza costi, che consente di mostrare i prodotti del negozio di un commerciante senza costi su Google.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa del programma. Formato: |
documentation_ |
Solo output. L'URL di una pagina di assistenza di Merchant Center che descrive il programma. |
state |
Solo output. Lo stato di partecipazione dell'account al programma. |
active_ |
Solo output. Le regioni in cui l'account partecipa attivamente al programma. Le regioni attive sono quelle in cui sono stati soddisfatti tutti i requisiti del programma che le interessano. I codici regione sono definiti da CLDR. Può essere un paese in cui il programma si applica specificamente o |
unmet_ |
Solo output. I requisiti che l'account non ha ancora soddisfatto e che influiscono sulla partecipazione al programma. |
Requisito
Definisce un requisito specificato per la partecipazione al programma.
Campi | |
---|---|
title |
Solo output. Nome del requisito. |
documentation_ |
Solo output. L'URL di una pagina di assistenza che descrive il requisito. |
affected_ |
Solo output. Le regioni attualmente interessate dal mancato rispetto di questo requisito. I codici regione sono definiti da CLDR. Può essere un paese in cui il programma si applica specificamente a quel paese o |
Stato
Possibili stati di partecipazione al programma per l'account.
Enum | |
---|---|
STATE_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
NOT_ELIGIBLE |
L'account non è idoneo a partecipare al programma. |
ELIGIBLE |
L'account è idoneo a partecipare al programma. |
ENABLED |
Il programma è abilitato per l'account. |
RateGroup
Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un applicable_shipping_labels
vuoto, che significa "tutto il resto". L'altro applicable_shipping_labels
non deve sovrapporsi.
Campi | |
---|---|
applicable_ |
Obbligatorio. Un elenco di etichette di spedizione che definiscono i prodotti a cui si applica questo gruppo di tariffe. Si tratta di una disgiunzione: per l'applicazione del gruppo di tariffe è sufficiente che corrisponda una delle etichette. Può essere vuoto solo per l'ultimo gruppo di tariffe di un servizio. |
subtables[] |
Facoltativo. Un elenco di sottotabelle a cui fa riferimento |
carrier_ |
Facoltativo. Un elenco di tariffe dell'operatore a cui è possibile fare riferimento tramite |
single_ |
Il valore del gruppo di tariffe (ad es. tariffa fissa 10 $). Può essere impostato solo se |
main_ |
Una tabella che definisce il gruppo di tariffe, quando |
name |
Facoltativo. Nome del gruppo di tariffe. Se impostato, deve essere univoco all'interno del servizio di spedizione. |
Regione
Rappresenta una regione geografica che puoi utilizzare come target sia con i servizi RegionalInventory
sia con ShippingSettings
. Puoi definire le regioni come raccolte di codici postali o, in alcuni paesi, utilizzando i geotarget predefiniti. Per ulteriori informazioni, consulta Configurare le regioni .
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della regione. Formato: |
postal_ |
Facoltativo. Un elenco di codici postali che definisce l'area della regione. |
geotarget_ |
Facoltativo. Un elenco di target geografici che definisce l'area della regione. |
regional_ |
Solo output. Indica se la regione è idonea per l'utilizzo nella configurazione dell'inventario regionale. |
shipping_ |
Solo output. Indica se la regione è idonea per l'utilizzo nella configurazione dei servizi di spedizione. |
display_ |
Facoltativo. Il nome visualizzato della regione. |
GeoTargetArea
Un elenco di target geografici che definisce l'area della regione.
Campi | |
---|---|
geotarget_ |
Obbligatorio. Un elenco non vuoto di ID posizione. Devono essere tutti dello stesso tipo di località (ad esempio stato). |
PostalCodeArea
Un elenco di codici postali che definisce l'area della regione. Nota: tutte le regioni definite utilizzando i codici postali sono accessibili tramite la risorsa ShippingSettings.postalCodeGroups
dell'account.
Campi | |
---|---|
region_ |
Obbligatorio. Codice di territorio CLDR o il paese a cui si applica il gruppo di codici postali. |
postal_ |
Obbligatorio. Un intervallo di codici postali. |
PostalCodeRange
Un intervallo di codici postali che definisce l'area della regione.
Campi | |
---|---|
begin |
Obbligatorio. Un codice postale o un pattern del prefisso del modulo* che indica il limite inferiore incluso dell'intervallo che definisce l'area. Valori di esempio: |
end |
Facoltativo. Un codice postale o un pattern del tipo |
Obbligatorio
Descrive i Termini di servizio che devono essere accettati.
Campi | |
---|---|
terms_ |
I termsOfService che devono essere accettati. |
tos_ |
URL completo del file dei Termini di servizio. Questo campo è uguale a TermsOfService.file_uri, ma è stato aggiunto qui solo per comodità. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
Messaggio di richiesta per il metodo RetrieveForApplicationTermsOfServiceAgreementState
.
Campi | |
---|---|
parent |
Obbligatorio. L'account per cui ottenere un formato TermsOfServiceAgreementState: |
RetrieveLatestTermsOfServiceRequest
Messaggio di richiesta per il metodo RetrieveLatestTermsOfService
.
Campi | |
---|---|
region_ |
Obbligatorio. Codice regione come definito da CLDR. Si tratta di un paese quando i TdS si applicano specificamente a quel paese o di 001 quando si applicano a livello globale. |
kind |
Obbligatorio. Il tipo a cui si applica questa versione dei Termini di servizio. |
Riga
Includi un elenco di celle.
Campi | |
---|---|
cells[] |
Obbligatorio. L'elenco di celle che costituiscono la riga. Deve avere la stessa lunghezza di |
Servizio
Servizio di spedizione.
Campi | |
---|---|
delivery_ |
Obbligatorio. Il codice di territorio CLDR dei paesi a cui si applica il servizio. |
rate_ |
Facoltativo. Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un |
loyalty_ |
Facoltativo. Programmi fedeltà a cui è limitato questo servizio di spedizione. |
service_ |
Obbligatorio. Nome libero del servizio. Deve essere univoco all'interno dell'account di destinazione. |
active |
Obbligatorio. Un valore booleano che mostra lo stato attivo del servizio di spedizione. |
currency_ |
Il codice CLDR della valuta a cui si applica questo servizio. Deve corrispondere a quello dei prezzi nei gruppi di tariffe. |
delivery_ |
Obbligatorio. Tempo impiegato per vari aspetti, dall'ordine alla consegna del prodotto. |
shipment_ |
Tipo di località in cui questo servizio spedisce gli ordini. |
minimum_ |
Valore minimo dell'ordine per questo servizio. Se impostato, indica che i clienti dovranno spendere almeno questo importo. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. Non può essere impostato insieme a minimum_order_value_table. |
minimum_ |
Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini con ritiro in negozio. Non può essere impostato insieme a minimum_order_value. |
store_ |
Un elenco dei negozi da cui vengono consegnati i tuoi prodotti. Questo vale solo per il tipo di spedizione di consegna locale. |
LoyaltyProgram
Programma fedeltà fornito da un commerciante.
Campi | |
---|---|
loyalty_ |
Facoltativo. Livello del programma fedeltà di questo servizio di spedizione. |
program_ |
Si tratta dell'etichetta del programma fedeltà configurata nelle impostazioni del programma fedeltà in Merchant Center. Questo attributo secondario consente a Google di mappare il tuo programma fedeltà alle offerte idonee. |
LoyaltyProgramTiers
Sottoinsieme di un programma fedeltà dei commercianti.
Campi | |
---|---|
tier_ |
L'attributo secondario etichetta del livello [tier_label] differenzia i vantaggi di ciascun livello dell'offerta. Questo valore è configurato anche nelle impostazioni del programma in Merchant Center ed è obbligatorio per le modifiche alle origini dati anche se il programma fedeltà ha un solo livello. |
ShipmentType
Tipo di spedizione del servizio di spedizione.
Enum | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Questo servizio non ha specificato il tipo di spedizione. |
DELIVERY |
Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. |
LOCAL_DELIVERY |
Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. L'ordine viene spedito da un negozio locale nelle vicinanze. |
COLLECTION_POINT |
Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. L'ordine viene spedito da un punto di ritiro. |
StoreConfig
Un elenco dei negozi da cui vengono consegnati i tuoi prodotti. Questo vale solo per il tipo di spedizione di consegna locale.
Campi | |
---|---|
store_ |
Facoltativo. Un elenco di codici negozio che offrono la consegna locale. Se vuoto, |
store_ |
Indica se tutti i negozi o negozi selezionati elencati da questo commerciante offrono la consegna locale. |
cutoff_ |
Le configurazioni relative alla consegna locale terminano per la giornata. |
service_ |
Raggio di consegna massimo. Questo è necessario solo per il tipo di spedizione con consegna locale. |
CutoffConfig
Le configurazioni relative alla consegna locale terminano per la giornata.
Campi | |
---|---|
local_ |
Ora di fine della consegna locale per la giornata. |
store_ |
Valido solo con l'evasione degli ordini locali. Rappresenta l'ora limite come numero di ore prima della chiusura del negozio. Si escludono a vicenda con |
no_ |
I commercianti possono disattivare la visualizzazione della consegna locale in n+1 giorni se hanno configurato un servizio di spedizione con consegna locale in n giorni. Ad esempio, se il servizio di spedizione definisce la consegna in giornata ed è trascorso il limite, l'impostazione di questo campo su |
LocalCutoffTime
Ora di fine della consegna locale per la giornata.
Campi | |
---|---|
hour |
Gli ordini con consegna locale devono essere effettuati entro questa ora per essere elaborati lo stesso giorno. |
minute |
Gli ordini con consegna locale devono essere effettuati entro questo orario per essere elaborati lo stesso giorno. |
StoreServiceType
Indica se tutti i negozi o negozi selezionati elencati dal commerciante offrono la consegna locale.
Enum | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
Non è stato specificato il tipo di servizio del negozio. |
ALL_STORES |
Indica se tutti i negozi, attuali e futuri, elencati da questo commerciante offrono la consegna locale. |
SELECTED_STORES |
Indica che solo i negozi elencati in store_codes sono idonei per la consegna locale. |
ShippingSettings
Le impostazioni di spedizione dell'account commerciante.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa dell'impostazione di spedizione. Formato: |
services[] |
Facoltativo. L'elenco dei servizi dell'account di destinazione. |
warehouses[] |
Facoltativo. Un elenco di magazzini a cui fare riferimento in |
etag |
Obbligatorio. Questo campo viene utilizzato per evitare problemi di accoppiamento asincrono. Assicurati che i dati delle impostazioni di spedizione non siano cambiati tra la chiamata get e la chiamata insert. L'utente deve seguire i seguenti passaggi:
|
Tabella
Una tabella che definisce il gruppo di tariffe, quando single_value
non è sufficientemente espressivo.
Campi | |
---|---|
rows[] |
Obbligatorio. L'elenco di righe che costituiscono la tabella. Deve avere la stessa lunghezza di |
name |
Nome della tabella. Obbligatorio per le sottotabelle, ignorato per la tabella principale. |
row_ |
Obbligatorio. Intestazioni delle righe della tabella. |
column_ |
Intestazioni delle colonne della tabella. Facoltativo: se non impostato, la tabella ha una sola dimensione. |
TermsOfService
Il messaggio TermsOfService
indica una versione specifica dei Termini di servizio che i commercianti devono accettare per accedere a determinate funzionalità o servizi (vedi https://support.google.com/merchants/answer/160173).
Questo messaggio è importante per la procedura di onboarding, in quanto garantisce che i commercianti accettino i contratti legali necessari per l'utilizzo del servizio. I commercianti possono recuperare i Termini di servizio più recenti per un determinato kind
e region
tramite RetrieveLatestTermsOfService
e accettarli come richiesto tramite AcceptTermsOfService
.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: |
region_ |
Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese o |
kind |
Il tipo a cui si applica questa versione dei Termini di servizio. |
external |
Indica se questa versione dei Termini di servizio è esterna. Le versioni dei Termini di servizio esterni possono essere accettate solo tramite procedure esterne e non direttamente dal commerciante tramite UI o API. |
file_ |
URI del file dei Termini di servizio che deve essere mostrato agli utenti che li firmano. |
TermsOfServiceAgreementState
Questa risorsa rappresenta lo stato del contratto per un determinato account e tipo di Termini di servizio. Lo stato è il seguente:
- Se il commerciante ha accettato i Termini di servizio, il valore accepted verrà inserito, altrimenti sarà vuoto
- Se il commerciante deve firmare i Termini di servizio, il campo required verrà compilato, altrimenti rimarrà vuoto.
Tieni presente che possono essere presenti sia required che accepted. In questo caso, i termini di servizio accepted
avranno una data di scadenza impostata nel campo valid_until. I Termini di servizio di required
devono essere accettati prima del giorno valid_until
affinché il contratto dell'account rimanga valido. Quando accettano i nuovi Termini di servizio, ci aspettiamo che le terze parti mostrino il testo associato al contratto relativo ai Termini di servizio specificati (l'URL del file contenente il testo viene aggiunto nel messaggio obbligatorio di seguito come tos_file_uri. L'accettazione effettiva dei Termini di servizio viene eseguita chiamando accept sulla risorsa TermsOfService.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: |
region_ |
Codice regione come definito da https://cldr.unicode.org/. Si tratta del paese a cui si applica lo stato attuale. |
terms_ |
Tipo di Termini di servizio associati alla versione specifica. |
accepted |
I Termini di servizio accettati di questo tipo e per il codice region_code associato |
required |
I Termini di servizio obbligatori |
TermsOfServiceKind
Il tipo TermsOfService.
Enum | |
---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
MERCHANT_CENTER |
Applicazione Merchant Center. |
TransitTable
Tabella del tempo di transito, numero di giorni lavorativi trascorsi in transito in base alle dimensioni di riga e colonna. Puoi impostare min_transit_days
, max_transit_days
o transit_time_table
, ma non entrambi.
Campi | |
---|---|
postal_ |
Obbligatorio. Un elenco di nomi di regioni |
transit_ |
Obbligatorio. Un elenco di etichette del tempo di transito. L'ultimo valore può essere |
rows[] |
Obbligatorio. Se è presente un solo insieme di dimensioni di |
TransitTimeRow
Se è presente un solo insieme di dimensioni di postal_code_group_names
o transit_time_labels
, esistono più righe con un valore per ogni dimensione. Se sono presenti due dimensioni, ogni riga corrisponde a un postal_code_group_names
e le colonne (valori) a un transit_time_labels
.
Campi | |
---|---|
values[] |
Obbligatorio. Intervallo di tempo di transito (min-max) in giorni lavorativi. |
TransitTimeValue
Intervallo di tempo di transito (min-max) in giorni lavorativi.
Campi | |
---|---|
min_ |
Intervallo di tempo di transito minimo in giorni lavorativi. 0 indica la consegna in giornata, 1 indica la consegna il giorno successivo. |
max_ |
Deve essere maggiore o uguale a |
UnclaimHomepageRequest
Messaggio di richiesta per il metodo UnclaimHomepage
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della home page di cui revocare la rivendicazione. Formato: |
UpdateAccountRequest
Messaggio di richiesta per il metodo UpdateAccount
.
Campi | |
---|---|
account |
Obbligatorio. La nuova versione dell'account. |
update_ |
Facoltativo. Elenco dei campi in fase di aggiornamento. I seguenti campi sono supportati (sia in
|
UpdateAutofeedSettingsRequest
Messaggio di richiesta per il metodo UpdateAutofeedSettings
.
Campi | |
---|---|
autofeed_ |
Obbligatorio. La nuova versione dell'impostazione del feed automatico. |
update_ |
Obbligatorio. Elenco dei campi in fase di aggiornamento. |
UpdateBusinessIdentityRequest
Messaggio di richiesta per il metodo UpdateBusinessIdentity
.
Campi | |
---|---|
business_ |
Obbligatorio. La nuova versione dell'identità dell'attività. |
update_ |
Facoltativo. Elenco dei campi in fase di aggiornamento. I seguenti campi sono supportati (sia in
|
UpdateBusinessInfoRequest
Messaggio di richiesta per il metodo UpdateBusinessInfo
.
Campi | |
---|---|
business_ |
Obbligatorio. La nuova versione delle informazioni sull'attività. |
update_ |
Facoltativo. Elenco dei campi in fase di aggiornamento. I seguenti campi sono supportati (sia in
|
UpdateEmailPreferencesRequest
Messaggio di richiesta per il metodo UpdateEmailPreferences.
Campi | |
---|---|
email_ |
Obbligatorio. Preferenze email da aggiornare. |
update_ |
Obbligatorio. Elenco dei campi in fase di aggiornamento. I seguenti campi sono supportati (sia in
|
UpdateHomepageRequest
Messaggio di richiesta per il metodo UpdateHomepage
.
Campi | |
---|---|
homepage |
Obbligatorio. La nuova versione della home page. |
update_ |
Facoltativo. Elenco dei campi in fase di aggiornamento. I seguenti campi sono supportati (sia in
|
UpdateRegionRequest
Messaggio di richiesta per il metodo UpdateRegion
.
Campi | |
---|---|
region |
Obbligatorio. La regione aggiornata. |
update_ |
Facoltativo. La maschera del campo separata da virgole che indica i campi da aggiornare. Esempio: |
UpdateUserRequest
Messaggio di richiesta per il metodo UpdateUser
.
Campi | |
---|---|
user |
Obbligatorio. La nuova versione dell'utente. Utilizza |
update_ |
Facoltativo. Elenco dei campi in fase di aggiornamento. I seguenti campi sono supportati (sia in
|
Utente
Il messaggio User
rappresenta un utente associato a un account Merchant Center. Viene utilizzato per gestire le autorizzazioni utente e i diritti di accesso all'interno dell'account. Per ulteriori informazioni, consulta le domande frequenti su persone e livelli di accesso.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa dell'utente. Formato: Utilizza |
state |
Solo output. Lo stato dell'utente. |
access_ |
Facoltativo. I diritti di accesso di cui dispone l'utente. |
Stato
I possibili stati di un utente.
Enum | |
---|---|
STATE_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
PENDING |
L'utente è in attesa di conferma. In questo stato, l'utente deve prima accettare l'invito prima di eseguire altre azioni. |
VERIFIED |
L'utente è verificato. |
Valore
Il singolo valore di un gruppo di tariffe o il valore della cella di una tabella di gruppi di tariffe. Deve essere impostato esattamente uno dei valori no_shipping
, flat_rate
, price_percentage
, carrier_rateName
, subtable_name
.
Campi | |
---|---|
no_ |
Se il valore è true, il prodotto non può essere spedito. Deve essere true se impostato, può essere impostato solo se tutti gli altri campi non sono impostati. |
flat_ |
Una tariffa fissa. Può essere impostato solo se non sono impostati tutti gli altri campi. |
price_ |
Una percentuale del prezzo rappresentata come numero in notazione decimale (ad es. |
carrier_ |
Il nome di una tariffa del corriere che fa riferimento a una tariffa del corriere definita nello stesso gruppo di tariffe. Può essere impostato solo se non sono impostati tutti gli altri campi. |
subtable |
Il nome di una sottotabella. Può essere impostato solo nelle celle della tabella (ad esempio, non per i singoli valori) e solo se non sono impostati tutti gli altri campi. |
Deposito
Un magazzino per l'evasione degli ordini, che gestisce e conserva l'inventario.
Campi | |
---|---|
name |
Obbligatorio. Il nome del magazzino. Deve essere univoco all'interno dell'account. |
shipping_ |
Obbligatorio. Indirizzo di spedizione del magazzino. |
cutoff_ |
Obbligatorio. L'ora più tardi in cui un ordine può essere accettato e iniziare l'elaborazione. Gli ordini successivi verranno elaborati il giorno successivo. L'ora si basa sul codice postale del magazzino. |
handling_ |
Obbligatorio. Il numero di giorni necessari a questo magazzino per imballare e spedire un articolo. Questo valore è a livello di magazzino, ma può essere ignorato a livello di offerta in base agli attributi di un articolo. |
business_ |
Giorni lavorativi del magazzino. Se non è impostato, per impostazione predefinita sarà dal lunedì al venerdì. |
WarehouseBasedDeliveryTime
Indica che il tempo di consegna deve essere calcolato in base al magazzino (località di partenza della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non deve essere impostato nessun altro campo relativo al tempo di transito in delivery_time
.
Campi | |
---|---|
carrier |
Obbligatorio. Operatore, ad esempio |
carrier_ |
Obbligatorio. Servizio dell'operatore, ad esempio |
warehouse |
Obbligatorio. Nome del magazzino. Deve corrispondere a [warehouse][ShippingSetting.warehouses.name] |
WarehouseCutoffTime
L'ora più tardi in cui è possibile accettare un ordine e iniziare l'elaborazione. Gli ordini successivi verranno elaborati il giorno successivo. L'ora si basa sul codice postale del magazzino.
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato lo stesso giorno dal magazzino. L'ora si basa sul fuso orario del magazzino. |
minute |
Obbligatorio. Minuto dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato lo stesso giorno dal magazzino. Il minuto si basa sul fuso orario del magazzino. |