Package google.shopping.merchant.accounts.v1beta

Indice

AccountIssueService

Servizio per il supporto dell'API AccountIssueService.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Elenca tutti i problemi di un account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

AccountTaxService

Gestisce i dati dell'impostazione fiscale a livello di account.

Questa API definisce il seguente modello di risorsa:

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

Restituisce le regole fiscali che soddisfano le condizioni di GetAccountTaxRequest

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListAccountTax

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

Elenca le impostazioni fiscali dei subaccount solo nel tuo account Merchant Center. Questo metodo può essere chiamato solo su un account multi-cliente, altrimenti restituirà un errore.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateAccountTax

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

Aggiorna le impostazioni fiscali dell'account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

AccountsService

Servizio per supportare l'API Account.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Crea un account Merchant Center autonomo con una configurazione aggiuntiva. Aggiunge l'utente che effettua la richiesta come amministratore per il nuovo account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Elenca tutti i subaccount di un determinato account multi-cliente. Si tratta di un pratico wrapper per il metodo ListAccounts, più efficace. Questo metodo produrrà gli stessi risultati della chiamata a ListsAccounts con il seguente filtro: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Aggiorna un account, indipendentemente dal tipo: autonomo, AMC o subaccount. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

BusinessIdentityService

Servizio per il supporto dell'API Business Identity.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Recupera l'identità dell'attività di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Aggiorna l'identità dell'attività di un account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

BusinessInfoService

Servizio di supporto dell'API di informazioni sull'attività.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Recupera le informazioni sull'attività di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Consente di aggiornare le informazioni sull'attività di un account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

EmailPreferencesService

Servizio per il supporto dell'API EmailPreferences.

Questo servizio consente solo il recupero e l'aggiornamento delle preferenze email degli utenti autenticati.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

HomepageService

Servizio per il supporto di un'API per la home page di un negozio.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

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).

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Recupera la home page di un negozio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Annulla la rivendicazione della home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Consente di aggiornare la home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

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

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Recupera le norme sui resi esistenti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Elenca tutte le norme sui resi esistenti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

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

rpc DisableProgram(DisableProgramRequest) returns (Program)

Disattiva la partecipazione al programma specificato per l'account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Abilita la partecipazione al programma specificato per l'account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Recupera il programma specificato per l'account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Recupera tutti i programmi per l'account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

RegionsService

Gestisce la configurazione delle regioni.

Questa API definisce il seguente modello di risorsa:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Crea una definizione di regione nel tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Elimina una definizione di regione dal tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Recupera una regione definita nel tuo account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Elenca le regioni nel tuo account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Aggiorna una definizione di regione nel tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ShippingSettingsService

Servizio per ottenere informazioni sulle impostazioni di spedizione della chiamata di metodo in base al metodo API Merchant.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Recupera le informazioni sulle impostazioni di spedizione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

TermsOfServiceAgreementStateService

Servizio per il supporto dell'API TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Restituisce lo stato di un contratto relativo ai Termini di servizio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Recupera lo stato del contratto per i termini di servizio dell'applicazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

TermsOfServiceService

Servizio per il supporto dell'API TermsOfService.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Accetta TermsOfService. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Recupera il valore TermsOfService associato alla versione fornita.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Recupera l'ultima versione di TermsOfService per kind e region_code specifici.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

UserService

Servizio per il supporto dell'API utente.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Crea un utente con account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Elimina l'utente di un account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetUser

rpc GetUser(GetUserRequest) returns (User)

Recupera l'utente di un account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Elenca tutti gli utenti di un account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Aggiorna l'utente di un account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

AcceptTermsOfServiceRequest

Messaggio di richiesta per il metodo AcceptTermsOfService.

Campi
name

string

Obbligatoria. Il nome della risorsa della versione dei Termini di servizio. Formato: termsOfService/{version}
account

string

Obbligatoria. L'account per il quale accettare i TdS.
region_code

string

Obbligatoria. 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

string

Si è trattato di termsOfService.
accepted_by

string

L'account in cui è stata registrata l'accettazione. Può trattarsi dell'account stesso o, nel caso di subaccount, dell'account AMC.
valid_until

Date

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

string

Identificatore. Il nome della risorsa dell'account. Formato: accounts/{account}
account_id

int64

Solo output. L'ID dell'account.
account_name

string

Obbligatoria. Un nome leggibile dell'account. Per ulteriori informazioni, vedi il nome del negozio e il nome dell'attività.
adult_content

bool

Se l'account include contenuti per adulti.
test_account

bool

Solo output. Indica se si tratta di un account di prova.
time_zone

TimeZone

Obbligatoria. Il fuso orario dell'account.

Durante la scrittura, time_zone imposta sia reporting_time_zone sia display_time_zone.

Per le letture, time_zone restituisce sempre display_time_zone. Se display_time_zone non esiste per il tuo account, il campo time_zone è vuoto.
language_code

string

Obbligatoria. Il codice lingua BCP-47 dell'account, ad esempio en-US o sr-Latn.

AccountIssue

Un AccountIssue.

Campi
name

string

Identificatore. Il nome della risorsa del problema relativo all'account. Formato: accounts/{account}/issues/{id}
title

string

Il titolo localizzato del problema.
severity

Severity

La gravità complessiva del problema.
impacted_destinations[]

ImpactedDestination

L'impatto di questo problema su varie destinazioni.
detail

string

Ulteriori dettagli localizzati sul problema.
documentation_uri

string

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[]

Impact

L'impatto (negativo) per varie regioni sulla destinazione specificata.
reporting_context

ReportingContextEnum

Il contesto del report interessato.

Impatto

L'impatto del problema su una regione.

Campi
region_code

string

Il codice regione CLDR in cui si applica questo problema.
severity

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 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

string

Identificatore. Il nome dell'impostazione fiscale. Formato: "{account_tax.name=accounts/{account}}"
account

int64

Solo output. L'ID dell'account a cui appartengono queste impostazioni fiscali.
tax_rules[]

TaxRule

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

string

Parte dell'indirizzo a livello stradale. Ad esempio: 111w 31st Street.
city

string

Obbligatoria. Città, paese o comune. Può includere anche località dipendenti o zone secondarie (ad esempio quartieri o sobborghi).
administrative_area

string

Obbligatoria. 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

string

Obbligatoria. Codice postale (ad esempio "94043").
region_code

string

Obbligatoria. Codice paese CLDR (ad es. "US").

BusinessDayConfig

Giorni lavorativi del magazzino.

Campi
business_days[]

Weekday

Obbligatoria. 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

string

Identificatore. Il nome risorsa dell'identità aziendale. Formato: accounts/{account}/businessIdentity
black_owned

IdentityAttribute

Campo 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 US. Inoltre, non è applicabile ai marketplace o ai venditori di marketplace.
women_owned

IdentityAttribute

Campo 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 US. Inoltre, non è applicabile ai marketplace o ai venditori di marketplace.
veteran_owned

IdentityAttribute

Campo 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 US. Inoltre, non è applicabile ai marketplace o ai venditori di marketplace.
latino_owned

IdentityAttribute

Campo 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 US. Inoltre, non è applicabile ai marketplace o ai venditori di marketplace.
small_business

IdentityAttribute

Campo 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 US. Inoltre, non è applicabile ai marketplace.

IdentityAttribute

Tutte le informazioni relative a un attributo riguardante l'identità.

Campi
identity_declaration

IdentityDeclaration

Obbligatoria. 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

BusinessInfo

Raccolta di informazioni relative a un'attività.

Campi
name

string

Identificatore. Nome risorsa delle informazioni sull'attività. Formato: accounts/{account}/businessInfo
address

PostalAddress

Campo facoltativo. L'indirizzo dell'attività commerciale.
phone

PhoneNumber

Campo facoltativo. Il numero di telefono dell'attività commerciale.
phone_verification_state

PhoneVerificationState

Solo output. Lo stato della verifica telefonica dell'attività commerciale.
customer_service

CustomerService

Campo 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

string

Obbligatoria. Nome della tariffa del corriere. Deve essere univoco per ogni gruppo di tariffe.
carrier

string

Obbligatoria. Servizio del corriere, ad esempio "UPS" o "Fedex".
carrier_service

string

Obbligatoria. Servizio del corriere, ad esempio "ground" o "2 days".
origin_postal_code

string

Obbligatoria. Origine della spedizione per questa tariffa del corriere.
percentage_adjustment

string

Campo facoltativo. Modificatore moltiplicativo per la tariffa di spedizione come numero in notazione decimale. Può essere negativo. Ad esempio, "5.4" aumenta la tariffa del 5,4%, "-3" la riduce del 3%.
flat_adjustment

Price

Campo facoltativo. Modificatore di tariffa di spedizione additivo. Può essere negativo. Ad esempio, { "amount_micros": 1, "currency_code" : "USD" } aggiunge 1 $alla tariffa, { "amount_micros": -3, "currency_code" : "USD" } ne rimuove 3 $.

ClaimHomepageRequest

Messaggio di richiesta per il metodo ClaimHomepage.

Campi
name

string

Obbligatoria. Il nome della home page da rivendicare. Formato: accounts/{account}/homepage

CreateAndConfigureAccountRequest

Messaggio di richiesta per il metodo CreateAndConfigureAccount.

Campi
account

Account

Obbligatoria. L'account da creare.
users[]

CreateUserRequest

Campo facoltativo. Utenti da aggiungere all'account.
service[]

AddAccountService

Campo facoltativo. Se specificato, un servizio di account tra l'account da creare e l'account del provider verrà inizializzato durante la creazione.
accept_terms_of_service

AcceptTermsOfService

Campo 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

string

Obbligatoria. Il nome della risorsa della versione dei Termini di servizio.
region_code

string

Obbligatoria. Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese oppure di 001, quando sono applicabili a livello globale.

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

Empty

Il fornitore è un aggregatore dell'account.
provider

string

Campo facoltativo. Il fornitore del servizio. Formato: accounts/{account}

CreateRegionRequest

Messaggio di richiesta per il metodo CreateRegion.

Campi
parent

string

Obbligatoria. L'account per il quale creare una regione. Formato: accounts/{account}
region_id

string

Obbligatoria. L'identificatore della regione, univoco in tutte le regioni dello stesso account.
region

Region

Obbligatoria. La regione da creare.

CreateUserRequest

Messaggio di richiesta per il metodo CreateUser.

Campi
parent

string

Obbligatoria. Il nome della risorsa dell'account per il quale verrà creato un utente. Formato: accounts/{account}
user_id

string

Obbligatoria. L'indirizzo email dell'utente (ad esempio john.doe@gmail.com).
user

User

Obbligatoria. L'utente da creare.

CustomerService

Informazioni sull'assistenza clienti.

Campi
uri

string

Campo facoltativo. L'URI in cui è possibile trovare l'assistenza clienti.
email

string

Campo facoltativo. L'indirizzo email al quale è possibile raggiungere l'assistenza clienti.
phone

PhoneNumber

Campo facoltativo. Il numero di telefono al quale è possibile chiamare l'assistenza clienti.

CutoffTime

Definizione dell'orario limite nei giorni lavorativi.

Campi
hour

int32

Obbligatoria. Ora dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno.
minute

int32

Obbligatoria. Minuto dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno.
time_zone

string

Obbligatoria. Identificatore del fuso orario, ad esempio "Europa/Zurigo".

DeleteAccountRequest

Messaggio di richiesta per il metodo DeleteAccount.

Campi
name

string

Obbligatoria. Il nome dell'account da eliminare. Formato: accounts/{account}

DeleteRegionRequest

Messaggio di richiesta per il metodo DeleteRegion.

Campi
name

string

Obbligatoria. Il nome della regione da eliminare. Formato: accounts/{account}/regions/{region}

DeleteUserRequest

Messaggio di richiesta per il metodo DeleteUser.

Campi
name

string

Obbligatoria. Il nome dell'utente da eliminare. Formato: accounts/{account}/users/{email}

È anche possibile eliminare l'utente corrispondente al chiamante utilizzando me anziché un indirizzo email, come in accounts/{account}/users/me.

DeliveryTime

Tempo trascorso in vari aspetti, dall'ordine alla consegna del prodotto.

Campi
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Campo 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

int32

Numero minimo di giorni lavorativi di transito. 0 significa la consegna in giornata, 1 significa la consegna il giorno successivo. È necessario impostare min_transit_days, max_transit_days o transit_time_table, ma non entrambi.
max_transit_days

int32

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 min_transit_days.
cutoff_time

CutoffTime

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

int32

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

int32

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 min_handling_days.
transit_time_table

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.
handling_business_day_config

BusinessDayConfig

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

BusinessDayConfig

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

string

Obbligatoria. Il nome del programma per il quale disattivare la partecipazione per l'account in questione. Formato: accounts/{account}/programs/{program}

Distanza

Raggio di consegna massimo. Questa operazione è necessaria solo per il tipo di spedizione con consegna locale.

Campi
value

int64

Valore intero della distanza.
unit

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

string

Identificatore. Il nome di EmailPreferences. L'endpoint è supportato solo per l'utente autenticato.
news_and_tips

OptInState

Campo 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

string

Obbligatoria. Il nome del programma per il quale consentire la partecipazione per l'account in questione. Formato: accounts/{account}/programs/{program}

GetAccountRequest

Messaggio di richiesta per il metodo GetAccount.

Campi
name

string

Obbligatoria. Il nome dell'account da recuperare. Formato: accounts/{account}

GetAccountTaxRequest

Richiedi di ottenere le impostazioni fiscali

Campi
name

string

Obbligatoria. Il nome da cui verranno recuperate le impostazioni fiscali

GetBusinessIdentityRequest

Messaggio di richiesta per il metodo GetBusinessIdentity.

Campi
name

string

Obbligatoria. Il nome risorsa dell'identità aziendale. Formato: accounts/{account}/businessIdentity

GetBusinessInfoRequest

Messaggio di richiesta per il metodo GetBusinessInfo.

Campi
name

string

Obbligatoria. Nome risorsa delle informazioni sull'attività. Formato: accounts/{account}/businessInfo

GetEmailPreferencesRequest

Messaggio di richiesta per il metodo GetEmailPreferences.

Campi
name

string

Obbligatoria. Il nome della risorsa EmailPreferences. Formato: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

Messaggio di richiesta per il metodo GetHomepage.

Campi
name

string

Obbligatoria. Il nome della home page da recuperare. Formato: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

Messaggio di richiesta per il metodo GetOnlineReturnPolicy.

Campi
name

string

Obbligatoria. Il nome della norma sui resi da recuperare. Formato: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

Messaggio di richiesta per il metodo GetProgram.

Campi
name

string

Obbligatoria. Il nome del programma da recuperare. Formato: accounts/{account}/programs/{program}

GetRegionRequest

Messaggio di richiesta per il metodo GetRegion.

Campi
name

string

Obbligatoria. Il nome della regione da recuperare. Formato: accounts/{account}/regions/{region}

GetShippingSettingsRequest

Messaggio di richiesta per il metodo GetShippingSetting.

Campi
name

string

Obbligatoria. Il nome dell'impostazione di spedizione da recuperare. Formato: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

Messaggio di richiesta per il metodo GetTermsOfServiceAgreementState.

Campi
name

string

Obbligatoria. Il nome della risorsa della versione dei Termini di servizio. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier}

GetTermsOfServiceRequest

Messaggio di richiesta per il metodo GetTermsOfService.

Campi
name

string

Obbligatoria. Il nome della risorsa della versione dei Termini di servizio. Formato: termsOfService/{version}

GetUserRequest

Messaggio di richiesta per il metodo GetUser.

Campi
name

string

Obbligatoria. Il nome dell'utente da recuperare. Formato: accounts/{account}/users/{email}

È anche possibile recuperare l'utente corrispondente al chiamante utilizzando me anziché un indirizzo email, come in accounts/{account}/users/me.

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[]

Price

Obbligatoria. 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 [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] rappresenta le intestazioni "<= $10", "<= $500" e "> $500". Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. Il campo non può essere vuoto. Deve essere positivo, tranne -1. Può essere impostato solo se tutti gli altri campi non sono impostati.
weights[]

Weight

Obbligatoria. 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 [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] rappresenta le intestazioni "<= 10 kg", "<= 50 kg" e "> 50 kg". Tutte le ponderazioni all'interno di un servizio devono avere la stessa unità. Il campo non può essere vuoto. Deve essere positivo, tranne -1. Può essere impostato solo se tutti gli altri campi non sono impostati.
number_of_items[]

string

Obbligatoria. Un elenco di un numero comprensivo di limiti superiori di elementi. L'ultimo valore può essere "infinity". Ad esempio ["10", "50", "infinity"] rappresenta le intestazioni "<= 10 elementi", "<= 50 elementi" e "> 50 elementi". Il campo non può essere vuoto. Può essere impostato solo se tutti gli altri campi non sono impostati.
postal_code_group_names[]

string

Obbligatoria. Un elenco di nomi di gruppi postali. L'ultimo valore può essere "all other locations". Esempio: ["zone 1", "zone 2", "all other locations"]. I gruppi di codici postali indicati devono corrispondere al paese di consegna del servizio. Il campo non può essere vuoto. Può essere impostato solo se tutti gli altri campi non sono impostati.
locations[]

LocationIdSet

Obbligatoria. 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

string

Identificatore. Il nome della risorsa della home page dell'archivio. Formato: accounts/{account}/homepage
claimed

bool

Solo output. Se la home page è rivendicata. Consulta la pagina https://support.google.com/merchants/answer/176793.
uri

string

Obbligatoria. L'URI (in genere un URL) della home page dello store.

InsertShippingSettingsRequest

Messaggio di richiesta per il metodo InsertShippingSetting.

Campi
parent

string

Obbligatoria. L'account in cui verrà inserito il prodotto. Formato: accounts/{account}
shipping_setting

ShippingSettings

Obbligatoria. La nuova versione dell'account.

ListAccountIssuesRequest

Messaggio di richiesta per il metodo ListAccountIssues.

Campi
parent

string

Obbligatoria. L'elemento principale, proprietario di questa raccolta di problemi. Formato: accounts/{account}
page_size

int32

Campo 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

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a ListAccountIssues. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListAccountIssues devono corrispondere alla chiamata che ha fornito il token della pagina.
language_code

string

Campo facoltativo. I problemi nella risposta avranno campi leggibili da una persona nella lingua specificata. Il formato è BCP-47, ad esempio en-US o sr-Latn. Se non viene fornito un valore, verrà utilizzato en-US.
time_zone

TimeZone

Campo 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, viene utilizzato "America/Los_Angeles".

ListAccountIssuesResponse

Messaggio di risposta per il metodo ListAccountIssues.

Campi
account_issues[]

AccountIssue

I problemi dell'account specificato.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ListAccountTaxRequest

Richiedi di elencare tutte le impostazioni fiscali del subaccount solo per il commerciante che ha inviato la richiesta Questo metodo può essere chiamato solo su un account multi-cliente, altrimenti restituirà un errore.

Campi
parent

string

Obbligatoria. L'account principale, proprietario di questa riscossione dell'imposta sull'account. Formato: accounts/{account}
page_size

int32

Il numero massimo di impostazioni fiscali da restituire nella risposta, utilizzato per il paging.
page_token

string

Il token restituito dalla richiesta precedente.

ListAccountTaxResponse

Risposta alla richiesta di elenco delle imposte dell'account Questo metodo può essere chiamato solo su un account multi-cliente, altrimenti restituirà un errore.

Campi
account_taxes[]

AccountTax

Pagina delle impostazioni fiscali dell'account
next_page_token

string

Il token per il recupero della pagina successiva delle impostazioni fiscali dell'account.

ListAccountsRequest

Messaggio di richiesta per il metodo ListAccounts.

Campi
page_size

int32

Campo facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, verranno restituiti al massimo 250 account. Il valore massimo è 500; i valori superiori a 500 verranno forzati a 500.
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a ListAccounts. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListAccounts devono corrispondere alla chiamata che ha fornito il token della pagina.
filter

string

Campo facoltativo. Un filtro facoltativo che consente di restituire solo gli account che corrispondono al filtro.

Ecco alcuni esempi di filtri validi:

  • accountName = "*store*" AND relationship(providerId = 123)
  • relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
  • (accountName = "storeA") OR (accountName = "storeB")
  • relationship(service( handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
  • relationship(callerHasAccessToProvider() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
  • (relationship(service(type = "ACCOUNT_MANAGEMENT") AND service(handshakeState = "PENDING"))) OR (accountName = "store" AND relationship(...))

I filtri a livello di account hanno la seguente semantica:

  • accountName Si riferisce al campo accountName dell'account.
  • relationship(...) Si riferisce a una relazione tra l'account e un altro account. All'interno della funzione è possibile specificare questa relazione.

I filtri a livello di relazione hanno la seguente semantica:

  • providerId Si riferisce all'ID numerico dell'account che è l'altro membro della relazione. Ad esempio, se il filtro deve essere limitato agli account che hanno una relazione con l'account accounts/name/123, providerId deve essere filtrato come providerId = 123.
  • callerHasAccessToProvider() In questo modo, gli account risultanti verranno limitati agli account che hanno una relazione con un altro account in cui l'utente chiamante ha accesso anche all'altro membro della relazione (o al fornitore).
  • externalAccountId Si riferisce all'ID account esterno configurato per la relazione.
  • accountIdAlias Si riferisce all'alias dell'ID account configurato per la relazione.
  • service(...) Si riferisce a un servizio fornito nell'ambito della relazione. Nota: una relazione tra due account può comprendere più servizi.

I filtri a livello di servizio hanno la seguente semantica:

  • handshakeState Si riferisce allo stato di handshake del servizio. Quando un servizio viene stabilito, a volte deve essere prima approvato dagli altri membri o da entrambi i membri della relazione. Di conseguenza, un servizio può essere nello stato PENDING o APPROVED.
  • type Si riferisce al tipo di servizio. I valori possibili sono:
    • ACCOUNT_MANAGEMENT Il fornitore gestisce l'account.
    • ACCOUNT_AGGREGATION Il fornitore è un aggregatore dell'account.

Il filtro segue un sottoinsieme della specifica del filtro AIP e la sua grammatica formale EBNF. La grammatica per questo filtro è più restrittiva e specifica

filter
    : accountFilterDisj
    | accountFilterConj
    ;
accountFilterDisj
    : "(" accountFilterConj " OR " accountFilterConj ")"
    ;
accountFilterConj
    : accountFilter {" AND " accountFilter}
    ;
accountFilter
    : accountNameFilter | relationshipFn
    ;
accountNameFilter
    : "accountName" comparator value
    ;
relationshipFn
    : "relationship(" relationshipConj ")"
    ;
relationshipConj
    : relationshipFilter {" AND " relationshipFilter}
    ;
relationshipFilter
    : "providerId = " numValue
    | "callerHasAccessToProvider()"
    | "externalAccountId" comparator value
    | "accountIdAlias" comparator value
    | serviceFn
    ;
serviceFn
    : "service(" serviceConj ")"
    ;
serviceConj
    : serviceFilter {" AND " serviceFilter}
    ;
serviceFilter
    : handshakeStateFilter
    | typeFilter
    ;
handshakeStateFilter
    : "handshakeState = " value
    ;
typeFilter
    : "type = " value
    ;
comparator
    : " = " | " != "
    ;

Inoltre, si applica quanto segue:

  • Ogni campo in una combinazione può essere visualizzato una sola volta (ad esempio, è possibile filtrare per accountName solo una volta a livello di account oppure per providerId solo una volta per ogni livello di relazione).
  • Per i campi stringa (come accountName o accountIdAlias) è possibile esprimere un operatore CONTAINS racchiudendo la query in *. Ad esempio, accountName = "*foo*" restituirà tutti gli account con accountName contenente foo. Puoi esprimere ortogonalmente un operatore NOT_CONTAINS utilizzando !=. Ad esempio, accountName != "*foo*" restituirà tutti gli account con un valore accountName che non contiene foo. Nota: è possibile cercare account il cui accountName contiene il carattere a stella * utilizzando ***.
  • Gli spazi vuoti aggiuntivi vengono ignorati.
  • Tutti i valori, ad eccezione dei valori solo numerici, devono essere racchiusi tra virgolette doppie.
  • Se viene utilizzata una disgiunzione, le congiunzioni su ciascun lato devono utilizzare le parentesi anche se la congiunzione contiene solo una singola espressione. Le parentesi non sono consentite altrove, ad eccezione delle chiamate di funzione (come relationship o service). Questo serve a esprimere chiaramente che le congiunzioni sono più forti delle disgiunzioni logicamente.

ListAccountsResponse

Messaggio di risposta per il metodo ListAccounts.

Campi
accounts[]

Account

Gli account corrispondenti a ListAccountsRequest.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ListOnlineReturnPoliciesRequest

Messaggio di richiesta per il metodo ListOnlineReturnPolicies.

Campi
parent

string

Obbligatoria. L'account commerciante per il quale elencare le norme sui resi. Formato: accounts/{account}
page_size

int32

Campo facoltativo. Il numero massimo di OnlineReturnPolicy risorse da restituire. Il servizio restituisce un valore inferiore a questo se il numero di norme sui resi per il commerciante specificato è inferiore al valore pageSize. Il valore predefinito è 10. Il valore massimo è 100. Se viene specificato un valore superiore al massimo, pageSize utilizzerà il valore massimo per impostazione predefinita.
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a ListOnlineReturnPolicies. Fornisci il token di pagina per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListOnlineReturnPolicies devono corrispondere alla chiamata che ha fornito il token della pagina. Il token restituito come nextPageToken nella risposta alla richiesta precedente.

ListOnlineReturnPoliciesResponse

Messaggio di risposta per il metodo ListOnlineReturnPolicies.

Campi
online_return_policies[]

OnlineReturnPolicy

I criteri di reso recuperati.
next_page_token

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ListProgramsRequest

Messaggio di richiesta per il metodo ListPrograms.

Campi
parent

string

Obbligatoria. Il nome dell'account per il quale recuperare tutti i programmi. Formato: accounts/{account}
page_size

int32

Campo 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; i valori superiori a 1000 verranno forzati a 1000.
page_token

string

Campo facoltativo. Un token di continuazione, ricevuto da una precedente chiamata ListPrograms. Forniscilo per recuperare la pagina successiva.

ListProgramsResponse

Messaggio di risposta per il metodo ListPrograms.

Campi
programs[]

Program

I programmi per l'account specificato.
next_page_token

string

Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ListRegionsRequest

Messaggio di richiesta per il metodo ListRegions.

Campi
parent

string

Obbligatoria. L'account per il quale elencare le regioni. Formato: accounts/{account}
page_size

int32

Campo 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; i valori superiori a 1000 verranno forzati a 1000.
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a ListRegions. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListRegions devono corrispondere alla chiamata che ha fornito il token della pagina.

ListRegionsResponse

Messaggio di risposta per il metodo ListRegions.

Campi
regions[]

Region

Le regioni del commerciante specificato.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ListSubAccountsRequest

Messaggio di richiesta per il metodo ListSubAccounts.

Campi
provider

string

Obbligatoria. L'account principale. Formato: accounts/{account}
page_size

int32

Campo facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, verranno restituiti al massimo 250 account. Il valore massimo è 500; i valori superiori a 500 verranno forzati a 500.
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a ListAccounts. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListAccounts devono corrispondere alla chiamata che ha fornito il token della pagina.

ListSubAccountsResponse

Messaggio di risposta per il metodo ListSubAccounts.

Campi
accounts[]

Account

Gli account per i quali l'account principale specificato è un aggregatore.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ListUsersRequest

Messaggio di richiesta per il metodo ListUsers.

Campi
parent

string

Obbligatoria. L'elemento principale, proprietario di questa raccolta di utenti. Formato: 'accounts/{account}
page_size

int32

Campo 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

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a ListUsers. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListUsers devono corrispondere alla chiamata che ha fornito il token della pagina.

ListUsersResponse

Messaggio di risposta per il metodo ListUsers.

Campi
users[]

User

Gli utenti dell'account specificato.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

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[]

string

Obbligatoria. 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[]

StoreCodeSetWithMov

Obbligatoria. 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 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.

Campi
store_codes[]

string

Campo facoltativo. Un elenco di codici negozio univoci o vuoto per il campo catch all.
value

Price

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

string

Identificatore. Il nome della risorsa OnlineReturnPolicy. Formato: accounts/{account}/onlineReturnPolicies/{return_policy}
return_policy_id

string

Solo output. ID norma sui resi generato da Google.
label

string

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[]

string

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

Policy

Le norme sui resi.
restocking_fee

RestockingFee

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[]

ReturnMethod

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[]

ItemCondition

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

ReturnShippingFee

La tariffa di spedizione per il reso. Da impostare solo quando il cliente deve scaricare e stampare l'etichetta di reso.
return_policy_uri

string

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

bool

Questo campo è obbligatorio e indica se il commerciante accetta solo i prodotti con problemi per i resi.
process_refund_days

int32

Il campo è facoltativo e specifica il numero di giorni necessari ai commercianti per elaborare i rimborsi.
accept_exchange

bool

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

Type

Tipo di criterio.
days

int64

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 NUMBER_OF_DAYS_AFTER_DELIVERY.

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 type.

type può essere solo uno dei seguenti:
fixed_fee

Price

Commissione di riassortimento fisso.
micro_percent

int32

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

Type

Tipo di tariffa di spedizione per il reso.
fixed_fee

Price

Importo fisso della tariffa di spedizione del reso. Questo valore è applicabile solo se il tipo è FIXED. Tratteremo la tariffa di spedizione per i resi come senza costi se il tipo è FIXED e questo valore non è impostato.

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

string

Identificatore. Il nome della risorsa del programma. Formato: accounts/{account}/programs/{program}
documentation_uri

string

Solo output. L'URL di una pagina di assistenza di Merchant Center che descrive il programma.
state

State

Solo output. Lo stato di partecipazione dell'account al programma.
active_region_codes[]

string

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 001, se il programma è applicabile a livello globale.
unmet_requirements[]

Requirement

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

string

Solo output. Nome del requisito.
documentation_uri

string

Solo output. L'URL di una pagina di assistenza che descrive il requisito.
affected_region_codes[]

string

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 001, se il programma è applicabile a livello globale.

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[]

string

Obbligatoria. 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[]

Table

Campo facoltativo. Un elenco di sottotabelle a cui fa riferimento main_table. Può essere impostato solo se è impostato main_table.
carrier_rates[]

CarrierRate

Campo facoltativo. Un elenco di tariffe del corriere a cui main_table o single_value può fare riferimento.
single_value

Value

Il valore del gruppo di tariffe (ad esempio, costo fisso 10 $). Può essere impostato solo se i criteri main_table e subtables non sono impostati.
main_table

Table

Una tabella che definisce il gruppo di tariffe, quando single_value non è abbastanza espressivo. Può essere impostato solo se il criterio single_value non è impostato.
name

string

Campo 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

string

Identificatore. Il nome della risorsa della regione. Formato: accounts/{account}/regions/{region}
postal_code_area

PostalCodeArea

Campo facoltativo. Un elenco di codici postali che definisce l'area della regione.
geotarget_area

GeoTargetArea

Campo facoltativo. Un elenco di target geografici che definisce l'area della regione.
regional_inventory_eligible

BoolValue

Solo output. Indica se la regione è idonea per essere utilizzata nella configurazione dell'inventario regionale.
shipping_eligible

BoolValue

Solo output. Indica se la regione è idonea per essere utilizzata nella configurazione dei servizi di spedizione.
display_name

string

Campo facoltativo. Il nome visualizzato della regione.

GeoTargetArea

Un elenco di target geografici che definisce l'area della regione.

Campi
geotarget_criteria_ids[]

int64

Obbligatoria. 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

string

Obbligatoria. Codice territorio CLDR o paese a cui si applica il gruppo di codici postali.
postal_codes[]

PostalCodeRange

Obbligatoria. Un intervallo di codici postali.

PostalCodeRange

Un intervallo di codici postali che definisce l'area della regione.

Campi
begin

string

Obbligatoria. 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: 94108, 9410*, 9*.
end

string

Campo facoltativo. Un codice postale o un modello nel formato prefix* che indica il limite superiore incluso dell'intervallo che definisce l'area. Deve avere la stessa lunghezza diPostalCodeRangeInizia: se postCodeRangeInizia è un codice postale, anche il codice postalePostalCodeRangeEnd deve essere anche di un codice postale. Se il codice postalePostalCodeRangeInizia è un pattern, il codice postaleCodeRangeEnd deve essere un pattern con la stessa lunghezza del prefisso. Facoltativo: se non è impostata, l'area è definita come l'insieme di tutti i codici postali corrispondenti aPostalCodeRangeInizia.

Obbligatorie

Descrive i Termini di servizio che devono essere accettati.

Campi
terms_of_service

string

La termsOfService che deve essere accettata.
tos_file_uri

string

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

string

Obbligatoria. L'account per cui ottenere un formato termsOfService AgreementState: accounts/{account}

RetrieveLatestTermsOfServiceRequest

Messaggio di richiesta per il metodo RetrieveLatestTermsOfService.

Campi
region_code

string

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

TermsOfServiceKind

Il tipo a cui si applica la versione dei termini di servizio.

Row

Includi un elenco di celle.

Campi
cells[]

Value

Obbligatoria. L'elenco di celle che costituiscono la riga. Deve avere la stessa lunghezza di columnHeaders per le tabelle bidimensionali e pari a 1 per le tabelle monodimensionali.

Servizio

Servizio di spedizione.

Campi
delivery_countries[]

string

Obbligatoria. Il codice di territorio CLDR dei paesi a cui si applica il servizio.
rate_groups[]

RateGroup

Campo facoltativo. 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.
loyalty_programs[]

LoyaltyProgram

Campo facoltativo. I programmi fedeltà a cui è limitato questo servizio di spedizione.
service_name

string

Obbligatoria. Nome in formato libero del servizio. Deve essere univoco all'interno dell'account di destinazione.
active

bool

Obbligatoria. Un valore booleano che mostra lo stato attivo del servizio di spedizione.
currency_code

string

Il codice CLDR della valuta a cui si applica il servizio. Deve corrispondere a quello dei prezzi nei gruppi di tariffe.
delivery_time

DeliveryTime

Obbligatoria. Tempo trascorso in vari aspetti, dall'ordine alla consegna del prodotto.
shipment_type

ShipmentType

Tipo di località in cui questo servizio spedisce gli ordini.
minimum_order_value

Price

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

MinimumOrderValueTable

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

StoreConfig

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[]

LoyaltyProgramTiers

Campo facoltativo. Livello del programma fedeltà di questo servizio di spedizione.
program_label

string

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

string

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[]

string

Campo facoltativo. Un elenco di codici negozio che offrono la consegna locale. Se vuoto, all_stores deve essere true.
store_service_type

StoreServiceType

Indica se tutti i negozi, o negozi selezionati, elencati da questo commerciante forniscono la consegna locale.
cutoff_config

CutoffConfig

Le configurazioni relative alla consegna locale terminano questa giornata.
service_radius

Distance

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

LocalCutoffTime

Ora di fine della consegna locale nel corso della giornata.
store_close_offset_hours

int64

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 local_cutoff_time.
no_delivery_post_cutoff

bool

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 true determina la restituzione di NO_DELIVERY_POST_CUTOFF per la tariffa del servizio di spedizione calcolata. Nello stesso esempio, l'impostazione di questo campo su false fa sì che il tempo di spedizione calcolato sia di un giorno. Valido solo per la consegna locale.

LocalCutoffTime

Ora di fine della consegna locale nel corso della giornata.

Campi
hour

int64

Gli ordini con consegna locale a un'ora devono essere effettuati entro per l'elaborazione nello stesso giorno.
minute

int64

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

string

Identificatore. Il nome della risorsa dell'impostazione di spedizione. Formato: accounts/{account}/shippingSetting
services[]

Service

Campo facoltativo. L'elenco di servizi dell'account di destinazione.
warehouses[]

Warehouse

Campo facoltativo. Un elenco di magazzini a cui è possibile fare riferimento in services.
etag

string

Obbligatoria. 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:

  1. Imposta il campo etag come stringa vuota per la creazione dell'impostazione di spedizione iniziale.

  2. Dopo la creazione iniziale, chiama il metodo get per ottenere un etag e i dati dell'impostazione di spedizione corrente prima dell'inserimento di chiamata.

  3. Modifica le impostazioni di spedizione desiderate.

  4. Chiama il metodo di inserimento con le informazioni sull'impostazione di spedizione desiderate con l'etag ottenuto nel passaggio 2.

  5. Se i dati delle impostazioni di spedizione sono cambiati tra il passaggio 2 e il passaggio 4. La richiesta di inserimento non andrà a buon fine perché l'etag cambia ogni volta che vengono modificati i dati dell'impostazione di spedizione. L'utente deve ripetere il passaggio 2-4 con il nuovo etag.

Tabella

Una tabella che definisce il gruppo di tariffe, quando single_value non è abbastanza espressivo.

Campi
rows[]

Row

Obbligatoria. L'elenco di righe che costituiscono la tabella. Deve avere la stessa lunghezza di row_headers.
name

string

Nome della tabella. Obbligatorio per le sottotabelle, ignorato per la tabella principale.
row_headers

Headers

Obbligatoria. Intestazioni delle righe della tabella.
column_headers

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

string

Codice regione in cui è applicabile questa regola
shipping_taxed

bool

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

Interval

Obbligatoria. 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

int64

L'id_admin o il_id_criteri della regione in cui è applicabile la regola.
post_code_range

TaxPostalCodeRange

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

bool

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

int64

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

string

Obbligatoria. L'inizio dell'intervallo di codici postali, che è anche il più piccolo nell'intervallo.
end

string

La fine dell'intervallo di codici postali. Corrisponde all'inizio, se non specificato.

TermsOfService

Un TermsOfService.

Campi
name

string

Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: termsOfService/{version}
region_code

string

Codice regione come definito da CLDR. Puoi scegliere un paese in cui i TdS si applicano specificamente a tale paese oppure 001 quando lo stesso TermsOfService può essere firmato in qualsiasi paese. Tuttavia, tieni presente che, quando firmi i TdS applicabili a livello globale, ci aspettiamo che venga indicato un paese specifico (deve essere il paese dell'attività del commerciante o il paese di partecipazione al programma).
kind

TermsOfServiceKind

Il tipo a cui si applica la versione dei termini di servizio.
external

bool

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

string

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

string

Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier}
region_code

string

Codice regione come definito da https://cldr.unicode.org/. È il paese a cui si applica lo stato attuale.
terms_of_service_kind

TermsOfServiceKind

Tipo di Termini di servizio associato alla versione specifica.
accepted

Accepted

I Termini di servizio accettati di questo tipo e per il valore regional_code associato
required

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[]

string

Obbligatoria. Un elenco di nomi di regioni Region.name . L'ultimo valore può essere "all other locations". Esempio: ["zone 1", "zone 2", "all other locations"]. I gruppi di codici postali indicati devono corrispondere al paese di consegna del servizio.
transit_time_labels[]

string

Obbligatoria. Un elenco di etichette del tempo di transito. L'ultimo valore può essere "all other labels". Esempio: ["food", "electronics", "all other labels"].
rows[]

TransitTimeRow

Obbligatoria. 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.

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[]

TransitTimeValue

Obbligatoria. 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

int32

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

int32

Deve essere maggiore o uguale a min_transit_days.

UnclaimHomepageRequest

Messaggio di richiesta per il metodo UnclaimHomepage.

Campi
name

string

Obbligatoria. Il nome della home page di cui annullare la rivendicazione. Formato: accounts/{account}/homepage

UpdateAccountRequest

Messaggio di richiesta per il metodo UpdateAccount.

Campi
account

Account

Obbligatoria. La nuova versione dell'account.
update_mask

FieldMask

Obbligatoria. Elenco dei campi in fase di aggiornamento.

UpdateAccountTaxRequest

Richiedere l'aggiornamento delle impostazioni fiscali

Campi
account_tax

AccountTax

Obbligatoria. L'impostazione fiscale che verrà aggiornata
update_mask

FieldMask

L'elenco dei campi da aggiornare

UpdateBusinessIdentityRequest

Messaggio di richiesta per il metodo UpdateBusinessIdentity.

Campi
business_identity

BusinessIdentity

Obbligatoria. La nuova versione dell'identità aziendale.
update_mask

FieldMask

Obbligatoria. Elenco dei campi in fase di aggiornamento.

UpdateBusinessInfoRequest

Messaggio di richiesta per il metodo UpdateBusinessInfo.

Campi
business_info

BusinessInfo

Obbligatoria. La nuova versione delle informazioni sull'attività.
update_mask

FieldMask

Obbligatoria. Elenco dei campi in fase di aggiornamento.

UpdateEmailPreferencesRequest

Messaggio di richiesta per il metodo UpdateEmailPreferences.

Campi
email_preferences

EmailPreferences

Obbligatoria. Preferenze email da aggiornare.
update_mask

FieldMask

Obbligatoria. Elenco dei campi in fase di aggiornamento.

UpdateHomepageRequest

Messaggio di richiesta per il metodo UpdateHomepage.

Campi
homepage

Homepage

Obbligatoria. La nuova versione della home page.
update_mask

FieldMask

Obbligatoria. Elenco dei campi in fase di aggiornamento.

UpdateRegionRequest

Messaggio di richiesta per il metodo UpdateRegion.

Campi
region

Region

Obbligatoria. La regione aggiornata.
update_mask

FieldMask

Campo facoltativo. La maschera dei campi separati da virgole che indica i campi da aggiornare. Esempio: "displayName,postalCodeArea.regionCode".

UpdateUserRequest

Messaggio di richiesta per il metodo UpdateUser.

Campi
user

User

Obbligatoria. La nuova versione dell'utente.

È anche possibile aggiornare l'utente corrispondente al chiamante utilizzando me anziché un indirizzo email nel campo del nome come in accounts/{account}/users/me.
update_mask

FieldMask

Obbligatoria. Elenco dei campi in fase di aggiornamento.

Utente

Un utente.

Campi
name

string

Identificatore. Il nome risorsa dell'utente. Formato: accounts/{account}/user/{user}
state

State

Solo output. Lo stato dell'utente.
access_rights[]

AccessRight

Campo 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

bool

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

Price

Costo fisso. Può essere impostato solo se tutti gli altri campi non sono impostati.
price_percentage

string

Una percentuale del prezzo rappresentata come numero con notazione decimale (ad es. "5.4"). Può essere impostata solo se tutti gli altri campi non sono impostati.
carrier_rate

string

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

string

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.

Warehouse

Un magazzino di distribuzione, che archivia e gestisce l'inventario. Tag successivo: 7

Campi
name

string

Obbligatoria. Il nome del magazzino. Deve essere univoco all'interno dell'account.
shipping_address

Address

Obbligatoria. Indirizzo di spedizione del magazzino.
cutoff_time

WarehouseCutoffTime

Obbligatoria. 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

int64

Obbligatoria. 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

BusinessDayConfig

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

string

Obbligatoria. Operatore, ad esempio "UPS" o "Fedex".
carrier_service

string

Obbligatoria. Servizio del corriere, ad esempio "ground" o "2 days". Il nome del servizio deve essere presente nell'elenco eddSupportedServices.
warehouse

string

Obbligatoria. 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

int32

Obbligatoria. 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

int32

Obbligatoria. 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.