Indice
AccountIssueService
(interfaccia)AccountTaxService
(interfaccia)AccountsService
(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)AccountIssue
(messaggio)AccountIssue.ImpactedDestination
(messaggio)AccountIssue.ImpactedDestination.Impact
(messaggio)AccountIssue.Severity
(enum)AccountTax
(messaggio)Address
(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.AcceptTermsOfService
(messaggio)CreateAndConfigureAccountRequest.AddAccountService
(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)GetAccountTaxRequest
(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)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)TaxRule
(messaggio)TaxRule.TaxPostalCodeRange
(messaggio)TermsOfService
(messaggio)TermsOfServiceAgreementState
(messaggio)TermsOfServiceKind
(enum)TransitTable
(messaggio)TransitTable.TransitTimeRow
(messaggio)TransitTable.TransitTimeRow.TransitTimeValue
(messaggio)UnclaimHomepageRequest
(messaggio)UpdateAccountRequest
(messaggio)UpdateAccountTaxRequest
(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 il supporto dell'API AccountIssueService
.
ListAccountIssues |
---|
Elenca tutti i problemi di un account Merchant Center.
|
AccountTaxService
Gestisce i dati dell'impostazione fiscale a livello di account.
Questa API definisce il seguente modello di risorsa:
AccountTax
GetAccountTax |
---|
Restituisce le regole fiscali che soddisfano le condizioni di GetAccountTaxRequest
|
UpdateAccountTax |
---|
Aggiorna le impostazioni fiscali dell'account.
|
AccountsService
Servizio per supportare l'API Account.
CreateAndConfigureAccount |
---|
Crea un account Merchant Center autonomo con una configurazione aggiuntiva. Aggiunge l'utente che effettua la richiesta come amministratore per il nuovo account.
|
DeleteAccount |
---|
Elimina l'account specificato indipendentemente dal tipo: autonomo, 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.
|
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 abbiano effetto.
|
ListAccounts |
---|
Elenca gli account accessibili all'utente chiamante e corrispondenti ai vincoli della richiesta, come le dimensioni della pagina o i filtri. Non si tratta solo di elencare i subaccount di un AMC, ma di tutti gli account a cui l'utente chiamante ha accesso, inclusi altri AMC, account collegati, account autonomi e così via.
|
ListSubAccounts |
---|
Elenca tutti i subaccount di un determinato account multi-cliente. Si tratta di un pratico wrapper per il metodo
|
UpdateAccount |
---|
Aggiorna un account, indipendentemente dal tipo: autonomo, AMC o subaccount. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
BusinessIdentityService
Servizio per il supporto dell'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 di supporto dell'API di informazioni sull'attività.
GetBusinessInfo |
---|
Recupera le informazioni sull'attività di un account.
|
UpdateBusinessInfo |
---|
Consente di aggiornare le informazioni sull'attività di un account. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
EmailPreferencesService
Servizio per il supporto dell'API EmailPreferences
.
Questo servizio consente solo il recupero e l'aggiornamento delle preferenze email degli utenti autenticati.
GetEmailPreferences |
---|
Restituisce le preferenze email di un utente dell'account Merchant Center. 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 dell'AMC anziché un subaccount dell'AMC. Le preferenze che non sono esplicitamente selezionate nella maschera di aggiornamento non verranno aggiornate. Non è valido se gli aggiornamenti specificano un valore per lo stato di attivazione NON CONFERMATO. Utilizza l'alias name=accounts/*/users/me/emailPreferences per aggiornare le preferenze per l'utente autenticato.
|
HomepageService
Servizio per il supporto di 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, verrà ricontrollata la verifica (a meno che il commerciante non sia esente dalla rivendicazione, il che a sua volta esenta la verifica) e restituirà una risposta corretta. 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; - rivendicazione non riuscita (in questo caso il messaggio di errore conterrà ulteriori dettagli).
|
GetHomepage |
---|
Recupera la home page di un negozio.
|
UnclaimHomepage |
---|
Annulla la rivendicazione della home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
UpdateHomepage |
---|
Consente di aggiornare la home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
OnlineReturnPolicyService
Il servizio facilita la gestione della configurazione delle norme sui resi per ripensamento di un commerciante, che comprende le norme sui resi sia per gli annunci che per le schede senza costi
programmi. Questa API definisce il seguente modello di risorsa:
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
Recupera le norme sui resi esistenti.
|
ListOnlineReturnPolicies |
---|
Elenca tutte le norme sui resi esistenti.
|
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 senza costi i prodotti del negozio di un commerciante su Google.
Questo servizio offre metodi per recuperare la partecipazione di un commerciante a tutti i programmi disponibili, oltre a metodi per abilitare o disabilitare esplicitamente la partecipazione a ciascun programma.
DisableProgram |
---|
Disattiva la partecipazione al programma specificato per l'account. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
EnableProgram |
---|
Abilita 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 risorsa:
Region
CreateRegion |
---|
Crea una definizione di regione nel tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
DeleteRegion |
---|
Elimina 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 della chiamata di metodo in base al metodo API Merchant.
GetShippingSettings |
---|
Recupera le informazioni sulle impostazioni di spedizione.
|
InsertShippingSettings |
---|
Sostituisci l'impostazione di spedizione di un commerciante con l'impostazione per la richiesta di spedizione. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
TermsOfServiceAgreementStateService
Servizio per il supporto dell'API TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Restituisce lo stato di un contratto relativo ai Termini di servizio.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
Recupera lo stato del contratto per i termini di servizio dell'applicazione.
|
TermsOfServiceService
Servizio per il supporto dell'API TermsOfService
.
AcceptTermsOfService |
---|
Accetta
|
GetTermsOfService |
---|
Recupera il valore
|
RetrieveLatestTermsOfService |
---|
Recupera l'ultima versione di
|
UserService
Servizio per il supporto dell'API utente.
CreateUser |
---|
Crea un utente con account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
DeleteUser |
---|
Elimina l'utente di un account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.
|
GetUser |
---|
Recupera l'utente di un account Merchant Center.
|
ListUsers |
---|
Elenca tutti gli utenti di un account Merchant Center.
|
UpdateUser |
---|
Aggiorna l'utente di un 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 il quale accettare i TdS. |
region_code |
Obbligatorio. Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese oppure dell'001 quando i TdS sono applicabili a livello globale. |
Accettato
Descrive i Termini di servizio accettati.
Campi | |
---|---|
terms_of_service |
Si è trattato di termsOfService. |
accepted_by |
L'account in cui è stata registrata l'accettazione. Può trattarsi dell'account stesso o, nel caso di subaccount, dell'account AMC. |
valid_until |
Se impostato, indica che i TermsOfService accettati sono validi solo fino alla fine di questa data (in UTC). Devi accettarne uno nuovo prima di questa data. Le informazioni relative ai TermsOfService richiesti si trovano 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 al rendimento e agli approfondimenti. |
Account
Un account.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa dell'account. Formato: |
account_id |
Solo output. L'ID dell'account. |
account_name |
Obbligatorio. Un nome leggibile dell'account. Per ulteriori informazioni, vedi il nome del negozio e il nome dell'attività. |
adult_content |
Se l'account include contenuti per adulti. |
test_account |
Solo output. Indica se si tratta di un account di prova. |
time_zone |
Obbligatorio. Il fuso orario dell'account. Durante la scrittura, Per le letture, |
language_code |
Obbligatorio. Il codice lingua BCP-47 dell'account, ad esempio |
AccountIssue
Un AccountIssue
.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa del problema relativo all'account. Formato: |
title |
Il titolo localizzato del problema. |
severity |
La gravità complessiva del problema. |
impacted_destinations[] |
L'impatto di questo problema su varie destinazioni. |
detail |
Ulteriori dettagli localizzati sul problema. |
documentation_uri |
Link al Centro assistenza Merchant Center per fornire 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_context |
Il contesto del report interessato. |
Impatto
L'impatto del problema su una regione.
Campi | |
---|---|
region_code |
Il codice regione CLDR in cui si applica questo problema. |
severity |
La gravità del problema nella destinazione e nella regione. |
Gravità
Tutte le possibili gravità del problema.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
La gravità è sconosciuta. |
CRITICAL |
Questo problema causa la mancata pubblicazione delle offerte. |
ERROR |
Il problema potrebbe influire sulle offerte (in futuro) o potrebbe essere un indicatore di problemi con le offerte. |
SUGGESTION |
Il problema è un suggerimento per migliorare. |
AccountTax
Le impostazioni fiscali di un account commerciante. Tutti i metodi richiedono il ruolo di amministratore.
Campi | |
---|---|
name |
Identificatore. Il nome dell'impostazione fiscale. Formato: "{account_tax.name=accounts/{account}}" |
account |
Solo output. L'ID dell'account a cui appartengono queste impostazioni fiscali. |
tax_rules[] |
Norme fiscali. "Definisci le regole fiscali per ogni regione. Non verranno indicate imposte se non esistono regole per una regione." |
Indirizzo
Indirizzo di spedizione del magazzino.
Campi | |
---|---|
street_address |
Parte dell'indirizzo a livello stradale. Ad esempio: |
city |
Obbligatorio. Città, paese o comune. Può includere anche località dipendenti o zone secondarie (ad esempio quartieri o sobborghi). |
administrative_area |
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_code |
Obbligatorio. Codice postale (ad esempio "94043"). |
region_code |
Obbligatorio. Codice paese CLDR (ad es. "US"). |
BusinessDayConfig
Giorni lavorativi del magazzino.
Campi | |
---|---|
business_days[] |
Obbligatorio. Giorni lavorativi normali. Il campo 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à aziendale. Formato: |
promotions_consent |
(Facoltativo) Indica se gli attributi riguardanti l'identità possono essere utilizzati per le promozioni. |
black_owned |
(Facoltativo) Specifica se l'attività si identifica come di proprietari neri. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
women_owned |
(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_owned |
(Facoltativo) Specifica se l'attività si identifica come di proprietà di un veterano. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
latino_owned |
(Facoltativo) Specifica se l'attività si identifica come di proprietari latinoamericani. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su |
small_business |
(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 riguardante l'identità.
Campi | |
---|---|
identity_declaration |
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 si identifica con l'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 dell'identità dell'attività per le promozioni. |
PROMOTIONS_CONSENT_DENIED |
Indica che l'account non ha acconsentito all'utilizzo dell'identità dell'attività per le promozioni. |
BusinessInfo
Raccolta di informazioni relative a un'attività.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa delle informazioni sull'attività. Formato: |
address |
(Facoltativo) L'indirizzo dell'attività commerciale. |
phone |
Solo output. Il numero di telefono dell'attività commerciale. |
phone_verification_state |
Solo output. Lo stato della verifica telefonica dell'attività commerciale. |
customer_service |
(Facoltativo) L'assistenza clienti dell'attività. |
CarrierRate
Un elenco di tariffe del corriere a cui main_table
o single_value
può fare riferimento.
Campi | |
---|---|
name |
Obbligatorio. Nome della tariffa del corriere. Deve essere univoco per ogni gruppo di tariffe. |
carrier |
Obbligatorio. Servizio del corriere, ad esempio |
carrier_service |
Obbligatorio. Servizio del corriere, ad esempio |
origin_postal_code |
Obbligatorio. Origine della spedizione per questa tariffa del corriere. |
percentage_adjustment |
(Facoltativo) Modificatore moltiplicativo per la tariffa di spedizione come numero in notazione decimale. Può essere negativo. Ad esempio, |
flat_adjustment |
(Facoltativo) Modificatore di tariffa di spedizione additivo. Può essere negativo. Ad esempio, |
ClaimHomepageRequest
Messaggio di richiesta per il metodo ClaimHomepage
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della home page da rivendicare. Formato: |
CreateAndConfigureAccountRequest
Messaggio di richiesta per il metodo CreateAndConfigureAccount
.
Campi | |
---|---|
account |
Obbligatorio. L'account da creare. |
users[] |
(Facoltativo) Utenti da aggiungere all'account. |
service[] |
(Facoltativo) Se specificato, un servizio di account tra l'account da creare e l'account del provider viene inizializzato durante la creazione. |
accept_terms_of_service |
(Facoltativo) I Termini di servizio (TdS) da accettare subito dopo la creazione dell'account. |
AcceptTermsOfService
Riferimento a una risorsa dei Termini di servizio.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa della versione dei Termini di servizio. |
region_code |
Obbligatorio. Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese oppure di |
AddAccountService
Istruzioni aggiuntive per aggiungere servizi dell'account durante la creazione dell'account.
Campi | |
---|---|
Campo unione service_type . Al momento è supportato solo il tipo di account principale Multi-cliente. service_type può essere solo uno dei seguenti: |
|
account_aggregation |
Il fornitore è un aggregatore dell'account. |
provider |
(Facoltativo) Il fornitore del servizio. Formato: |
CreateRegionRequest
Messaggio di richiesta per il metodo CreateRegion
.
Campi | |
---|---|
parent |
Obbligatorio. L'account per il quale creare una regione. Formato: |
region_id |
Obbligatorio. L'identificatore della regione, univoco in 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 il quale verrà creato un utente. Formato: |
user_id |
Obbligatorio. L'indirizzo email dell'utente (ad esempio, |
user |
Obbligatorio. 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 al quale è possibile raggiungere l'assistenza clienti. |
phone |
(Facoltativo) Il numero di telefono al quale è possibile chiamare l'assistenza clienti. |
CutoffTime
Definizione dell'orario limite nei giorni lavorativi.
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno. |
minute |
Obbligatorio. Minuto dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno. |
time_zone |
Obbligatorio. Identificatore del fuso orario, ad esempio "Europa/Zurigo". |
DeleteAccountRequest
Messaggio di richiesta per il metodo DeleteAccount
.
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'account da eliminare. Formato: |
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 al chiamante utilizzando |
DeliveryTime
Tempo trascorso in vari aspetti, dall'ordine alla consegna del prodotto.
Campi | |
---|---|
warehouse_based_delivery_times[] |
(Facoltativo) Indica che i tempi di consegna devono essere calcolati per magazzino (località di origine della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non è necessario impostare nessun altro campo relativo al tempo di transito in [tempo di consegna][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
min_transit_days |
Numero minimo di giorni lavorativi di transito. 0 significa la consegna in giornata, 1 significa la consegna il giorno successivo. È necessario impostare |
max_transit_days |
Numero massimo di giorni lavorativi trascorsi in transito. 0 significa la consegna in giornata, 1 significa la consegna il giorno successivo. Deve essere maggiore o uguale a |
cutoff_time |
Definizione dell'orario limite nei giorni lavorativi. Se non viene configurato, l'orario limite verrà impostato in modo predefinito sulle 8:00 PST. |
min_handling_days |
Numero minimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 significa che viene spedito lo stesso giorno, 1 significa che verrà spedito il giorno successivo. |
max_handling_days |
Numero massimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 significa che viene spedito lo stesso giorno, 1 significa che verrà spedito il giorno successivo. Deve essere maggiore o uguale a |
transit_time_table |
Tabella del tempo di transito, numero di giorni lavorativi di transito in base alle dimensioni di riga e colonna. È possibile impostare |
handling_business_day_config |
I giorni lavorativi durante i quali è possibile gestire gli ordini. Se non viene specificato, vengono utilizzati i giorni lavorativi dal lunedì al venerdì. |
transit_business_day_config |
I giorni lavorativi durante i quali gli ordini possono essere in transito. Se non viene specificato, vengono utilizzati i giorni lavorativi dal lunedì al venerdì. |
DisableProgramRequest
Messaggio di richiesta per il metodoDisableProgram.
Campi | |
---|---|
name |
Obbligatorio. Il nome del programma per il quale disattivare la partecipazione per l'account in questione. Formato: |
Distanza
Raggio di consegna massimo. Questa operazione è necessaria 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 per 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 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_and_tips |
(Facoltativo) Aggiornamenti su nuove funzionalità, suggerimenti e best practice. |
OptInState
Stato di attivazione della preferenza email.
Enum | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
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 (valida solo per alcuni paesi). |
EnableProgramRequest
Messaggio di richiesta per il metodo EnableProgram.
Campi | |
---|---|
name |
Obbligatorio. Il nome del programma per il quale consentire la partecipazione per l'account in questione. Formato: |
GetAccountRequest
Messaggio di richiesta per il metodo GetAccount
.
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'account da recuperare. Formato: |
GetAccountTaxRequest
Richiedi di ottenere le impostazioni fiscali
Campi | |
---|---|
name |
Obbligatorio. Il nome da cui verranno recuperate le impostazioni fiscali |
GetBusinessIdentityRequest
Messaggio di richiesta per il metodo GetBusinessIdentity
.
Campi | |
---|---|
name |
Obbligatorio. Il nome risorsa dell'identità aziendale. 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 della norma 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 al chiamante utilizzando |
Intestazioni
Un elenco non vuoto di intestazioni di riga o colonna per una tabella. Deve essere impostato esattamente uno dei seguenti valori: prices
, weights
, num_items
, postal_code_group_names
o location
.
Campi | |
---|---|
prices[] |
Obbligatorio. Un elenco di limiti superiori del prezzo dell'ordine inclusivo. Il valore dell'ultimo prezzo può essere infinito impostando importo_micros del prezzo su -1. Ad esempio |
weights[] |
Obbligatorio. Un elenco di limiti superiori inclusivi del peso dell'ordine. Il valore dell'ultimo peso può essere infinito impostando price_quantity_micros su -1. Ad esempio |
number_of_items[] |
Obbligatorio. Un elenco di un numero comprensivo di limiti superiori di elementi. L'ultimo valore può essere |
postal_code_group_names[] |
Obbligatorio. Un elenco di nomi di gruppi postali. L'ultimo valore può essere |
locations[] |
Obbligatorio. Un elenco di insiemi di ID località. Il campo non può essere vuoto. Può essere impostato solo se tutti gli altri campi non sono impostati. |
Home page
La home page di un negozio.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della home page dell'archivio. Formato: |
claimed |
Solo output. Se la home page è rivendicata. Consulta la pagina https://support.google.com/merchants/answer/176793. |
uri |
Obbligatorio. L'URI (in genere un URL) della home page dello store. |
InsertShippingSettingsRequest
Messaggio di richiesta per il metodo InsertShippingSetting
.
Campi | |
---|---|
parent |
Obbligatorio. L'account in cui verrà inserito il prodotto. Formato: accounts/{account} |
shipping_setting |
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_size |
(Facoltativo) Il numero massimo di problemi da restituire. Il servizio potrebbe restituire un valore inferiore a 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_token |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
language_code |
(Facoltativo) I problemi nella risposta avranno campi leggibili da una persona nella lingua specificata. Il formato è BCP-47, ad esempio |
time_zone |
(Facoltativo) Il fuso orario IANA utilizzato per localizzare gli orari in campi leggibili da una persona. Ad esempio "America/Los_Angeles". Se non viene configurato, "America/Los_Angeles" . |
ListAccountIssuesResponse
Messaggio di risposta per il metodo ListAccountIssues
.
Campi | |
---|---|
account_issues[] |
I problemi dell'account specificato. |
next_page_token |
Un token, che può essere inviato come |
ListAccountsRequest
Messaggio di richiesta per il metodo ListAccounts
.
Campi | |
---|---|
page_size |
(Facoltativo) Il numero massimo di account da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, vengono restituiti al massimo 250 account. Il valore massimo è 500. valori superiori a 500 vengono forzati a 500. |
page_token |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
filter |
(Facoltativo) Restituisce solo gli account che corrispondono al filtro. Per maggiori dettagli, consulta il riferimento sulla sintassi dei filtri. |
ListAccountsResponse
Messaggio di risposta per il metodo ListAccounts
.
Campi | |
---|---|
accounts[] |
Gli account corrispondenti a |
next_page_token |
Un token, che può essere inviato come |
ListOnlineReturnPoliciesRequest
Messaggio di richiesta per il metodo ListOnlineReturnPolicies
.
Campi | |
---|---|
parent |
Obbligatorio. L'account commerciante per il quale elencare le norme sui resi. Formato: |
page_size |
(Facoltativo) Il numero massimo di |
page_token |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
ListOnlineReturnPoliciesResponse
Messaggio di risposta per il metodo ListOnlineReturnPolicies
.
Campi | |
---|---|
online_return_policies[] |
I criteri di reso recuperati. |
next_page_token |
Un token, che può essere inviato come |
ListProgramsRequest
Messaggio di richiesta per il metodo ListPrograms.
Campi | |
---|---|
parent |
Obbligatorio. Il nome dell'account per il quale recuperare tutti i programmi. Formato: |
page_size |
(Facoltativo) Il numero massimo di programmi da restituire in una singola risposta. Se non specificata (o 0), viene utilizzata la dimensione predefinita di 1000. Il valore massimo è 1000; valori superiori a 1000 verranno forzati a 1000. |
page_token |
(Facoltativo) Un token di continuazione, ricevuto da una precedente chiamata |
ListProgramsResponse
Messaggio di risposta per il metodo ListPrograms.
Campi | |
---|---|
programs[] |
I programmi per l'account specificato. |
next_page_token |
Un token che può essere inviato come |
ListRegionsRequest
Messaggio di richiesta per il metodo ListRegions
.
Campi | |
---|---|
parent |
Obbligatorio. L'account per il quale elencare le regioni. Formato: |
page_size |
(Facoltativo) Il numero massimo di regioni da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, verranno restituite al massimo 50 regioni. Il valore massimo è 1000; valori superiori a 1000 verranno forzati a 1000. |
page_token |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
ListRegionsResponse
Messaggio di risposta per il metodo ListRegions
.
Campi | |
---|---|
regions[] |
Le regioni del commerciante specificato. |
next_page_token |
Un token, che può essere inviato come |
ListSubAccountsRequest
Messaggio di richiesta per il metodo ListSubAccounts
.
Campi | |
---|---|
provider |
Obbligatorio. L'account principale. Formato: |
page_size |
(Facoltativo) Il numero massimo di account da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, vengono restituiti al massimo 250 account. Il valore massimo è 500. valori superiori a 500 vengono forzati a 500. |
page_token |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
ListSubAccountsResponse
Messaggio di risposta per il metodo ListSubAccounts
.
Campi | |
---|---|
accounts[] |
Gli account per i quali l'account principale specificato è un aggregatore. |
next_page_token |
Un token, che può essere inviato come |
ListUsersRequest
Messaggio di richiesta per il metodo ListUsers
.
Campi | |
---|---|
parent |
Obbligatorio. L'elemento principale, proprietario di questa raccolta di utenti. Formato: |
page_size |
(Facoltativo) Il numero massimo di utenti da restituire. Il servizio potrebbe restituire un valore inferiore a 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_token |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
ListUsersResponse
Messaggio di risposta per il metodo ListUsers
.
Campi | |
---|---|
users[] |
Gli utenti dell'account specificato. |
next_page_token |
Un token, che può essere inviato come |
LocationIdSet
Un elenco di insiemi di ID località. Il campo non può essere vuoto. Può essere impostato solo se tutti gli altri campi non sono impostati.
Campi | |
---|---|
location_ids[] |
Obbligatorio. Un elenco non vuoto di ID località. 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 di ritiro.
Campi | |
---|---|
store_code_set_with_movs[] |
Obbligatorio. Un elenco di insiemi di codici negozio che condividono lo stesso valore minimo dell'ordine (MOV). Sono richiesti almeno due insiemi e l'ultimo deve essere vuoto, a indicare che si tratta di "MOV for all other stores". Ogni codice negozio può apparire una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. |
StoreCodeSetWithMov
Un elenco di insiemi di codici negozio che condividono lo stesso valore minimo dell'ordine. Sono obbligatori almeno due insiemi e l'ultimo deve essere vuoto, a indicare che si tratta di "MOV for all other stores". Ogni codice negozio può apparire una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta.
Campi | |
---|---|
store_codes[] |
(Facoltativo) Un elenco di codici negozio univoci o vuoto per il campo catch all. |
value |
Il valore minimo dell'ordine per i negozi specificati. |
OnlineReturnPolicy
Oggetto Norme sui resi online. Al momento vengono utilizzati per rappresentare le norme sui resi per i programmi relativi agli annunci e alle schede senza costi.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa |
return_policy_id |
Solo output. ID norma sui resi generato da Google. |
label |
Questo campo rappresenta l'etichetta univoca definita dall'utente della norma sui resi. È importante tenere presente 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 di etichetta specifico, le norme verranno etichettate automaticamente come "predefinite". Per assegnare le norme sui resi personalizzate a determinati gruppi di prodotti, segui le istruzioni fornite nell'etichetta delle norme sui resi. L'etichetta può contenere fino a 50 caratteri. |
countries[] |
I paesi di vendita in cui si applicano le norme sui resi. I valori devono essere un codice ISO 3166 valido di due lettere. |
policy |
Le norme sui resi. |
restocking_fee |
La commissione di riassortimento che si applica a tutte le categorie di motivi dei resi. Se il valore non viene impostato, questo viene considerato come una commissione di riassortimento senza costi. |
return_methods[] |
I metodi di reso di un articolo che i clienti possono utilizzare. Questo valore non deve essere vuoto, a meno che il tipo di norma sui resi non sia noReturns. |
item_conditions[] |
Le condizioni degli articoli accettate per i resi non devono essere vuote, a meno che il tipo di norma sui resi non sia "noReturns". |
return_shipping_fee |
La tariffa di spedizione per il reso. Da impostare solo quando il cliente deve scaricare e stampare l'etichetta di reso. |
return_policy_uri |
L'URI delle norme sui resi. Questa opzione può essere utilizzata da Google per eseguire un controllo di integrità per le norme. Deve essere un URL valido. |
accept_defective_only |
Questo campo è obbligatorio e indica se il commerciante accetta solo i prodotti con problemi per i resi. |
process_refund_days |
Il campo è facoltativo e specifica il numero di giorni necessari ai commercianti per elaborare i rimborsi. |
accept_exchange |
Questo campo è obbligatorio e specifica se il commerciante consente ai clienti di scambiare prodotti. |
ItemCondition
Le condizioni disponibili per gli articoli.
Enum | |
---|---|
ITEM_CONDITION_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
NEW |
Nuovo. |
USED |
Utilizzato. |
Norme
I criteri disponibili.
Campi | |
---|---|
type |
Tipo di criterio. |
days |
Il numero di giorni in cui gli articoli possono essere restituiti dopo la consegna, dove un giorno viene definito come 24 ore dopo il timestamp della consegna. Obbligatorio per i resi a |
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 il quale un reso è valido dopo la consegna. |
NO_RETURNS |
Nessun reso. |
LIFETIME_RETURNS |
Il ritorno della vita. |
RestockingFee
La commissione di riassortimento. Può essere una tariffa fissa o una micropercentuale.
Campi | |
---|---|
Campo unione
|
|
fixed_fee |
Commissione di riassortimento fisso. |
micro_percent |
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 per posta. |
IN_STORE |
Restituire in negozio. |
AT_A_KIOSK |
Torna presso un chiosco. |
ReturnShippingFee
La tariffa di spedizione per il reso. Può essere una tariffa fissa o un valore booleano per indicare che il costo di spedizione effettivo è a carico del cliente.
Campi | |
---|---|
type |
Tipo di tariffa di spedizione per il reso. |
fixed_fee |
Importo fisso della tariffa di spedizione del reso. Questo valore è applicabile solo se il tipo è |
Tipo
Tipi di tariffa di spedizione per i resi.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
FIXED |
La tariffa di spedizione per il reso è un valore fisso. |
CUSTOMER_PAYING_ACTUAL_FEE |
I clienti pagheranno l'effettivo costo di spedizione per il reso. |
PhoneVerificationState
Lo stato di verifica del numero di telefono.
Enum | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
PHONE_VERIFICATION_STATE_VERIFIED |
Il telefono è stato 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 senza costi i prodotti del negozio di un commerciante su Google.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa del programma. Formato: |
documentation_uri |
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_region_codes[] |
Solo output. Le regioni in cui l'account partecipa attivamente al programma. Sono definite regioni attive quelle in cui sono stati soddisfatti tutti i requisiti del programma che interessano le regioni. I codici regione sono definiti da CLDR. Puoi scegliere un paese in cui il programma si applica specificamente a tale paese oppure |
unmet_requirements[] |
Solo output. I requisiti non ancora soddisfatti dall'account che influiscono sulla partecipazione al programma. |
Requisito
Definisce un requisito specificato per la partecipazione al programma.
Campi | |
---|---|
title |
Solo output. Nome del requisito. |
documentation_uri |
Solo output. L'URL di una pagina di assistenza che descrive il requisito. |
affected_region_codes[] |
Solo output. Le regioni attualmente interessate da questo requisito non sono soddisfatte. I codici regione sono definiti da CLDR. Puoi scegliere un paese in cui il programma si applica specificamente a tale paese oppure |
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 campo applicable_shipping_labels
vuoto, che significa "tutto il resto". Gli altri applicable_shipping_labels
non devono sovrapporsi.
Campi | |
---|---|
applicable_shipping_labels[] |
Obbligatorio. Un elenco di etichette di spedizione che definiscono i prodotti a cui si applica questo gruppo di tariffe. Questa è una disgiunzione: solo una delle etichette deve corrispondere affinché il gruppo di tariffe venga applicato. Può essere vuoto solo per l'ultimo gruppo di tariffe di un servizio. |
subtables[] |
(Facoltativo) Un elenco di sottotabelle a cui fa riferimento |
carrier_rates[] |
(Facoltativo) Un elenco di tariffe del corriere a cui |
single_value |
Il valore del gruppo di tariffe (ad esempio, costo fisso 10 $). Può essere impostato solo se i criteri |
main_table |
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 con entrambi i servizi RegionalInventory
e ShippingSettings
. Puoi definire le regioni come raccolte di codici postali o, in alcuni paesi, utilizzando target geografici predefiniti. Per saperne di più, vedi Configurare le regioni .
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della regione. Formato: |
postal_code_area |
(Facoltativo) Un elenco di codici postali che definisce l'area della regione. |
geotarget_area |
(Facoltativo) Un elenco di target geografici che definisce l'area della regione. |
regional_inventory_eligible |
Solo output. Indica se la regione è idonea per essere utilizzata nella configurazione dell'inventario regionale. |
shipping_eligible |
Solo output. Indica se la regione è idonea per essere utilizzata nella configurazione dei servizi di spedizione. |
display_name |
(Facoltativo) Il nome visualizzato della regione. |
GeoTargetArea
Un elenco di target geografici che definisce l'area della regione.
Campi | |
---|---|
geotarget_criteria_ids[] |
Obbligatorio. Un elenco non vuoto di ID località. 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_code |
Obbligatorio. Codice territorio CLDR o paese a cui si applica il gruppo di codici postali. |
postal_codes[] |
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 inclusivo dell'intervallo che definisce l'area. Valori di esempio: |
end |
(Facoltativo) Un codice postale o un modello nel formato |
Obbligatorio
Descrive i Termini di servizio che devono essere accettati.
Campi | |
---|---|
terms_of_service |
La termsOfService che deve essere accettata. |
tos_file_uri |
URL completo al file dei Termini di servizio. Questo campo è uguale a TermsOfService.file_uri e viene aggiunto solo per praticità. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
Messaggio di richiesta per il metodo RetrieveForApplicationTermsOfServiceAgreementState
.
Campi | |
---|---|
parent |
Obbligatorio. L'account per cui ottenere un formato termsOfService AgreementState: |
RetrieveLatestTermsOfServiceRequest
Messaggio di richiesta per il metodo RetrieveLatestTermsOfService
.
Campi | |
---|---|
region_code |
Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese oppure dell'001 quando i TdS sono applicabili a livello globale. |
kind |
Il tipo a cui si applica la 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_countries[] |
Obbligatorio. Il codice di territorio CLDR dei paesi a cui si applica il servizio. |
rate_groups[] |
(Facoltativo) Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un campo |
loyalty_programs[] |
(Facoltativo) I programmi fedeltà a cui è limitato questo servizio di spedizione. |
service_name |
Obbligatorio. Nome in formato 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_code |
Il codice CLDR della valuta a cui si applica il servizio. Deve corrispondere a quello dei prezzi nei gruppi di tariffe. |
delivery_time |
Obbligatorio. Tempo trascorso in vari aspetti, dall'ordine alla consegna del prodotto. |
shipment_type |
Tipo di località in cui questo servizio spedisce gli ordini. |
minimum_order_value |
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 aminimum_order_value_table. |
minimum_order_value_table |
Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini di ritiro. Non può essere impostato insieme aminimum_order_value. |
store_config |
Un elenco dei negozi dai quali vengono consegnati i tuoi prodotti. È valido solo per il tipo di spedizione con consegna locale. |
LoyaltyProgram
Programma fedeltà fornito da un commerciante.
Campi | |
---|---|
loyalty_program_tiers[] |
(Facoltativo) Livello del programma fedeltà di questo servizio di spedizione. |
program_label |
Questa è l'etichetta del programma fedeltà configurata nelle relative impostazioni 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_label |
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 all'origine dati anche se il programma fedeltà ha un solo livello. |
ShipmentType
Tipo di servizio di spedizione.
Enum | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Per questo servizio non è stato 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 dai quali vengono consegnati i tuoi prodotti. È valido solo per il tipo di spedizione con consegna locale.
Campi | |
---|---|
store_codes[] |
(Facoltativo) Un elenco di codici negozio che offrono la consegna locale. Se vuoto, |
store_service_type |
Indica se tutti i negozi, o negozi selezionati, elencati da questo commerciante forniscono la consegna locale. |
cutoff_config |
Le configurazioni relative alla consegna locale terminano questa giornata. |
service_radius |
Raggio di consegna massimo. Questa operazione è necessaria solo per il tipo di spedizione con consegna locale. |
CutoffConfig
Le configurazioni relative alla consegna locale terminano questa giornata.
Campi | |
---|---|
local_cutoff_time |
Ora di fine della consegna locale nel corso della giornata. |
store_close_offset_hours |
Valido solo con evasione della consegna locale. Rappresenta l'orario limite come numero di ore prima della chiusura del negozio. Si escludono a vicenda con |
no_delivery_post_cutoff |
I commercianti possono disattivare la visualizzazione della consegna locale in n più giorni se hanno un servizio di spedizione configurato per la consegna locale in n giorni. Ad esempio, se il servizio di spedizione definisce la consegna in giornata ed ha superato l'orario limite, l'impostazione di questo campo su |
LocalCutoffTime
Ora di fine della consegna locale nel corso della giornata.
Campi | |
---|---|
hour |
Gli ordini con consegna locale a un'ora devono essere effettuati entro per l'elaborazione nello stesso giorno. |
minute |
Gli ordini con consegna locale in minuti devono essere effettuati entro per essere elaborati lo stesso giorno. |
StoreServiceType
Indica se tutti i negozi, o negozi selezionati, elencati dal commerciante forniscono 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 forniscono la consegna locale. |
SELECTED_STORES |
Indica che solo i negozi elencati in store_codes sono idonei alla consegna locale. |
ShippingSettings
L'[impostazione di spedizione]((https://support.google.com/merchants/answer/6069284) dell'account commerciante.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa dell'impostazione di spedizione. Formato: |
services[] |
(Facoltativo) L'elenco di servizi dell'account di destinazione. |
warehouses[] |
(Facoltativo) Un elenco di magazzini a cui è possibile fare riferimento in |
etag |
Obbligatorio. Questo campo viene utilizzato per evitare problemi asincroni. Assicurati che i dati dell'impostazione di spedizione non siano cambiati tra la richiesta di ricezione e quella di inserimento della chiamata. L'utente deve procedere nel seguente modo:
|
Tabella
Una tabella che definisce il gruppo di tariffe, quando single_value
non è abbastanza 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_headers |
Obbligatorio. Intestazioni delle righe della tabella. |
column_headers |
Intestazioni delle colonne della tabella. (Facoltativo) Se non è impostata, la tabella ha una sola dimensione. |
TaxRule
Convenzione di tipo primario
micro percentuale : 100% = 1.000.000 e 1% = 10.000 non può essere negativo.
Informazioni sulla presenza fiscale e sui parametri correlati applicabili agli ordini consegnati nell'area coperta da un unico amministratore delle imposte. Il Nexus viene creato quando un commerciante svolge attività in un'area gestita dall'amministratore delle imposte (solo gli stati USA sono supportati per la configurazione nexus). Se il commerciante ha una presenza fiscale in uno stato degli Stati Uniti, il commerciante deve pagare le imposte a tutte le autorità fiscali associate alla destinazione della spedizione. ID successivo : 8
Campi | |
---|---|
region_code |
Codice regione in cui è applicabile questa regola |
shipping_taxed |
Se impostato, viene applicata l'imposta sulla spedizione (alla stessa aliquota del prodotto) per la consegna nell'area di questo amministratore. Può essere impostato solo per gli stati degli Stati Uniti senza categoria. |
effective_time_period |
Obbligatorio. Periodo di tempo in cui ha effetto questa regola. Se la durata non è presente nell'elenco di valore effettivo, la durata è aperta a una data futura. L'inizio di questo periodo di tempo è inclusivo, mentre la fine è esclusiva. |
Campo unione location . Descrivi la località tramite un intervallo di codici postali o un ID criterio. location può essere solo uno dei seguenti: |
|
location_id |
L'id_admin o il_id_criteri della regione in cui è applicabile la regola. |
post_code_range |
L'intervallo di codici postali in cui si applica questa regola. |
Campo unione rate_calculation . Come si calcola l'aliquota fiscale per le consegne nell'area di questo amministratore? Può essere impostato solo negli stati degli Stati Uniti. rate_calculation può essere solo uno dei seguenti: |
|
use_google_rate |
Tariffa che dipende dalla località di consegna: se il commerciante ha una presenza fisica nello stato degli Stati Uniti corrispondente, vengono sommate le tariffe applicate dalle autorità con giurisdizione sulla zona di consegna. |
self_specified_rate_micros |
Un tasso fisso specificato in micro, dove 100% = 1_000_000. Adatto a stati che applicano il principio di origine. |
TaxPostalCodeRange
Un intervallo di codici postali che definisce l'area.
Campi | |
---|---|
start |
Obbligatorio. L'inizio dell'intervallo di codici postali, che è anche il più piccolo nell'intervallo. |
end |
La fine dell'intervallo di codici postali. Corrisponde all'inizio, se non specificato. |
TermsOfService
Un TermsOfService
.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: |
region_code |
Codice regione come definito da CLDR. Puoi scegliere un paese in cui i TdS si applicano specificamente a tale paese oppure |
kind |
Il tipo a cui si applica la versione dei termini di servizio. |
external |
Indica se la versione dei Termini di servizio è esterna. Le versioni esterne dei Termini di servizio possono essere accettate solo tramite processi esterni e non direttamente dal commerciante tramite interfaccia utente o API. |
file_uri |
URI del file dei Termini di servizio che deve essere mostrato agli utenti che firmano. |
TermsOfServiceAgreementState
Questa risorsa rappresenta lo stato del contratto per un determinato account e tipo Termini di servizio. Lo stato è il seguente:
- Se il commerciante ha accettato i Termini di servizio, il campo accepted sarà compilato, altrimenti il campo sarà vuoto
- Se il commerciante deve firmare i Termini di servizio, sarà compilato il campo required, altrimenti sarà vuoto.
Tieni presente che possono essere presenti sia obbligatori sia accettati. In questo caso, i Termini di servizio di accepted
avranno una data di scadenza impostata nel campo valid_until. Affinché l'account continui ad avere un contratto valido, è necessario accettare i Termini di servizio di required
prima del giorno valid_until
. Quando accetti i nuovi Termini di servizio, ci aspettiamo che le terze parti mostrino il testo associato al contratto relativo ai Termini di servizio specificato (l'URL del file contenente il testo viene aggiunto nel messaggio obbligatorio riportato di seguito come tos_file_uri. L'accettazione effettiva dei Termini di servizio viene eseguita richiamando il pulsante Accetto nella risorsa TermsOfService.
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: |
region_code |
Codice regione come definito da https://cldr.unicode.org/. È il paese a cui si applica lo stato attuale. |
terms_of_service_kind |
Tipo di Termini di servizio associato alla versione specifica. |
accepted |
I Termini di servizio accettati di questo tipo e per il valore regional_code associato |
required |
I Termini di servizio richiesti |
TermsOfServiceKind
La tipologia di Termini del servizio.
Enum | |
---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
MERCHANT_CENTER |
l'applicazione Merchant Center. |
TransitTable
Tabella del tempo di transito, numero di giorni lavorativi di transito in base alle dimensioni di riga e colonna. È possibile impostare min_transit_days
, max_transit_days
o transit_time_table
, ma non entrambi.
Campi | |
---|---|
postal_code_group_names[] |
Obbligatorio. Un elenco di nomi di regioni |
transit_time_labels[] |
Obbligatorio. Un elenco di etichette del tempo di transito. L'ultimo valore può essere |
rows[] |
Obbligatorio. Se è presente un solo insieme di dimensioni |
TransitTimeRow
Se è presente un solo insieme di dimensioni postal_code_group_names
o transit_time_labels
, sono presenti più righe, ciascuna con un valore per quella 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 del tempo di transito (min-max) in giorni lavorativi. |
TransitTimeValue
Intervallo del tempo di transito (min-max) in giorni lavorativi.
Campi | |
---|---|
min_transit_days |
Intervallo di tempo di transito minimo in giorni lavorativi. 0 significa la consegna in giornata, 1 significa la consegna il giorno successivo. |
max_transit_days |
Deve essere maggiore o uguale a |
UnclaimHomepageRequest
Messaggio di richiesta per il metodo UnclaimHomepage
.
Campi | |
---|---|
name |
Obbligatorio. Il nome della home page di cui annullare la rivendicazione. Formato: |
UpdateAccountRequest
Messaggio di richiesta per il metodo UpdateAccount
.
Campi | |
---|---|
account |
Obbligatorio. La nuova versione dell'account. |
update_mask |
Obbligatorio. Elenco dei campi in fase di aggiornamento. |
UpdateAccountTaxRequest
Richiedere l'aggiornamento delle impostazioni fiscali
Campi | |
---|---|
account_tax |
Obbligatorio. L'impostazione fiscale che verrà aggiornata |
update_mask |
L'elenco dei campi da aggiornare |
UpdateBusinessIdentityRequest
Messaggio di richiesta per il metodo UpdateBusinessIdentity
.
Campi | |
---|---|
business_identity |
Obbligatorio. La nuova versione dell'identità aziendale. |
update_mask |
Obbligatorio. Elenco dei campi in fase di aggiornamento. |
UpdateBusinessInfoRequest
Messaggio di richiesta per il metodo UpdateBusinessInfo
.
Campi | |
---|---|
business_info |
Obbligatorio. La nuova versione delle informazioni sull'attività. |
update_mask |
Obbligatorio. Elenco dei campi in fase di aggiornamento. |
UpdateEmailPreferencesRequest
Messaggio di richiesta per il metodo UpdateEmailPreferences.
Campi | |
---|---|
email_preferences |
Obbligatorio. Preferenze email da aggiornare. |
update_mask |
Obbligatorio. Elenco dei campi in fase di aggiornamento. |
UpdateHomepageRequest
Messaggio di richiesta per il metodo UpdateHomepage
.
Campi | |
---|---|
homepage |
Obbligatorio. La nuova versione della home page. |
update_mask |
Obbligatorio. Elenco dei campi in fase di aggiornamento. |
UpdateRegionRequest
Messaggio di richiesta per il metodo UpdateRegion
.
Campi | |
---|---|
region |
Obbligatorio. La regione aggiornata. |
update_mask |
(Facoltativo) La maschera dei campi separati 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. Usa |
update_mask |
Obbligatorio. Elenco dei campi in fase di aggiornamento. |
Utente
Un utente.
Campi | |
---|---|
name |
Identificatore. Il nome risorsa dell'utente. Formato: Usa |
state |
Solo output. Lo stato dell'utente. |
access_rights[] |
(Facoltativo) I diritti di accesso dell'utente. |
Stato
Gli stati possibili 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 accettare l'invito prima di eseguire altre azioni. |
VERIFIED |
L'utente è stato verificato. |
Valore
Valore singolo di un gruppo di tariffe o valore della cella della tabella di un gruppo di tariffe. Deve essere impostato esattamente uno dei seguenti valori: no_shipping
, flat_rate
, price_percentage
, carrier_rateName
, subtable_name
.
Campi | |
---|---|
no_shipping |
In questo caso, il prodotto non può essere spedito. Il valore deve essere true se viene impostato. Può essere impostato solo se tutti gli altri campi non sono impostati. |
flat_rate |
Costo fisso. Può essere impostato solo se tutti gli altri campi non sono impostati. |
price_percentage |
Una percentuale del prezzo rappresentata come numero in notazione decimale (ad esempio, |
carrier_rate |
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 tutti gli altri campi non sono impostati. |
subtable |
Il nome di una sottotabella. Può essere impostato solo nelle celle della tabella (ad esempio, non per singoli valori) e solo se tutti gli altri campi non sono impostati. |
Deposito
Un magazzino di distribuzione, che archivia e gestisce l'inventario. Tag successivo: 7
Campi | |
---|---|
name |
Obbligatorio. Il nome del magazzino. Deve essere univoco all'interno dell'account. |
shipping_address |
Obbligatorio. Indirizzo di spedizione del magazzino. |
cutoff_time |
Obbligatorio. L'ultima ora del giorno in cui un ordine può essere accettato e iniziare l'elaborazione. Gli ordini successivi verranno elaborati nel giorno successivo. L'ora si basa sul codice postale del magazzino. |
handling_days |
Obbligatorio. Il numero di giorni necessari per imballare e spedire un articolo in questo magazzino. È a livello di magazzino, ma può essere sostituito a livello di offerta in base agli attributi di un articolo. |
business_day_config |
Giorni lavorativi del magazzino. Se non viene configurato, per impostazione predefinita sarà da lunedì a venerdì. |
WarehouseBasedDeliveryTime
Indica che i tempi di consegna devono essere calcolati per magazzino (località di origine della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non è necessario impostare altri campi relativi al tempo di transito in delivery_time
.
Campi | |
---|---|
carrier |
Obbligatorio. Operatore, ad esempio |
carrier_service |
Obbligatorio. Servizio del corriere, ad esempio |
warehouse |
Obbligatorio. Nome warehouse. Deve corrispondere a [warehouse][ShippingSetting.warehouses.name]. |
WarehouseCutoffTime
L'ultima ora del giorno in cui un ordine può essere accettato e iniziare l'elaborazione. Gli ordini successivi verranno elaborati nel giorno successivo. L'ora si basa sul codice postale del magazzino.
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno dal magazzino. L'ora si basa sul fuso orario del magazzino. |
minute |
Obbligatorio. Minuto dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno dal magazzino. I minuti sono basati sul fuso orario del magazzino. |